2024-05-11 22:22:20 +03:00
< br >
< div align = "center" >
2024-05-12 00:15:05 +03:00
2024-05-13 02:54:48 +03:00
[<img src="./resources/icon.png" width="144"/> ](https://hydralauncher.site )
2024-05-12 00:15:05 +03:00
2024-05-11 22:22:20 +03:00
< h1 align = "center" > Hydra Launcher< / h1 >
2024-09-09 19:03:33 +03:00
2024-05-11 22:22:20 +03:00
< p align = "center" >
2024-05-12 04:23:35 +03:00
< strong > Hydra é um Launcher de Jogos com seu próprio cliente de bittorrent integrado e um wrapper autogerenciado para busca de repacks.< / strong >
2024-05-11 22:22:20 +03:00
< / p >
2024-05-13 02:54:48 +03:00
[![build ](https://img.shields.io/github/actions/workflow/status/hydralauncher/hydra/build.yml )](https://github.com/hydralauncher/hydra/actions)
[![release ](https://img.shields.io/github/package-json/v/hydralauncher/hydra )](https://github.com/hydralauncher/hydra/releases)
2024-05-12 00:15:05 +03:00
2024-09-04 23:15:23 +03:00
[![pt-BR ](https://img.shields.io/badge/lang-pt--BR-green.svg )](README.pt-BR.md)
2024-05-13 02:54:48 +03:00
[![en ](https://img.shields.io/badge/lang-en-red.svg )](README.md)
[![ru ](https://img.shields.io/badge/lang-ru-yellow.svg )](README.ru.md)
[![uk-UA ](https://img.shields.io/badge/lang-uk--UA-blue )](README.uk-UA.md)
2024-09-04 23:15:23 +03:00
[![be ](https://img.shields.io/badge/lang-be-orange )](README.be.md)
2024-05-23 07:58:22 +03:00
[![es ](https://img.shields.io/badge/lang-es-red )](README.es.md)
2024-06-02 20:28:35 +03:00
[![fr ](https://img.shields.io/badge/lang-fr-blue )](README.fr.md)
2024-09-10 02:40:16 +03:00
[![de ](https://img.shields.io/badge/lang-de-black )](README.de.md)
2024-09-04 23:15:23 +03:00
[![ita ](https://img.shields.io/badge/lang-it-red )](README.it.md)
2024-09-10 16:56:11 +03:00
[![cs ](https://img.shields.io/badge/lang-cs-purple )](README.cs.md)
2024-05-23 07:58:22 +03:00
2024-05-13 02:54:48 +03:00
![Hydra Catalogue ](./docs/screenshot.png )
2024-05-11 22:22:20 +03:00
< / div >
2024-05-12 00:21:10 +03:00
## Índice
2024-05-11 22:22:20 +03:00
2024-09-04 23:15:23 +03:00
- [Índice ](#índice )
2024-09-10 02:53:16 +03:00
- [Sobre ](#-sobre )
- [Recursos ](#-recursos )
- [Instalação ](#-instalação )
- [Contribuindo ](#-contribuindo )
- [Junte-se ao nosso Telegram ](#-junte-se-ao-nosso-telegram )
- [Fork e clone o seu repositório ](#-fork-e-clone-o-seu-repositório )
- [Formas de contribuir ](#-formas-de-contribuir )
- [Estrutura do Projeto ](#-estrutura-do-projeto )
- [Compile a partir do código-fonte ](#-compile-a-partir-do-código-fonte )
- [Instale Node.js ](#-instale-nodejs )
- [Instale Yarn ](#-instale-yarn )
- [Instale Dependencias do Node ](#-instale-dependencias-do-node )
- [Instale Python 3.9 ](#-instale-python-39 )
- [Instale Python Dependencies ](#-instale-python-dependencies )
- [Environment variables ](#-environment-variables )
- [Running ](#-running )
- [Build ](#-build )
- [Build the bittorrent client ](#-build-the-bittorrent-client )
- [Build the Electron application ](#-build-the-electron-application )
- [Contributors ](#-contributors )
- [Licença ](#-licença )
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
## <a name="about"> Sobre
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
**Hydra** é um **Launcher de Jogos** com seu próprio **Cliente BitTorrent incorporado** e um **raspador de repack auto-gerenciado** .
2024-05-11 22:22:20 +03:00
< br >
2024-05-12 04:23:35 +03:00
O launcher é escrito em TypeScript (Electron) e Python, que lida com o sistema de torrent usando libtorrent.
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
## <a name="features"> Recursos
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
- Wrapper de repacks auto-gerenciado entre todos os sites mais confiáveis no [Megathread ]("https://www.reddit.com/r/Piracy/wiki/megathread/" )
- Cliente BitTorrent incorporado próprio
- Integração com [How Long To Beat (HLTB) ](https://howlongtobeat.com/ ) na página do jogo
- Personalização do caminho de downloads
- Notificações de atualização da lista de repacks
- Suporte para Windows e Linux
- Constantemente atualizado
- E mais ...
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
## <a name="installation"> Instalação
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Siga os passos abaixo para instalar:
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
1. Baixe a versão mais recente do Hydra na página de [Releases ](https://github.com/hydralauncher/hydra/releases/latest ).
- Baixe apenas o .exe se quiser instalar o Hydra no Windows.
- Baixe .deb ou .rpm ou .zip se quiser instalar o Hydra no Linux. (depende da sua distribuição Linux)
2. Execute o arquivo baixado.
3. Aproveite o Hydra!
2024-05-11 22:22:20 +03:00
## <a name="contributing"> Contribuindo
### <a name="join-our-telegram"></a> Junte-se ao nosso Telegram
Concentramos nossas discussões no nosso canal do [Telegram ](https://t.me/hydralauncher ).
2024-05-12 04:23:35 +03:00
### <a name="fork-and-clone-your-repository"></a> Fork e clone o seu repositório
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
1. Faça um fork do repositório [(clique aqui para fazer o fork agora) ](https://github.com/hydralauncher/hydra/fork )
2. Clone o código do seu fork `git clone https://github.com/seu_nome_de_usuário/hydra`
3. Crie uma nova branch
4. Faça o push dos seus commits
5. Envie um novo Pull Request
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="ways-you-can-contribute"></a> Formas de contribuir
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
- **Tradução**: Queremos que o Hydra esteja disponível para o maior número possível de pessoas. Sinta-se à vontade para ajudar a traduzir para novos idiomas ou atualizar e melhorar aqueles que já estão disponíveis no Hydra.
- **Código**: O Hydra é construído com Typescript, Electron e um pouco de Python. Se você deseja contribuir, junte-se ao nosso [Telegram ](https://t.me/hydralauncher )!
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="project-structure"></a> Estrutura do Projeto
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
- torrent-client: Utilizamos o libtorrent, uma biblioteca Python, para gerenciar downloads via torrent.
- src/renderer: A interface de usuário (UI) da aplicação.
- src/main: Toda a lógica da aplicação reside aqui.
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
## <a name="build-from-source"></a> Compile a partir do código-fonte
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="install-nodejs"></a> Instale Node.js
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Certifique-se de ter o Node.js instalado em sua máquina. Se não, faça o download e instale-o em [nodejs.org ](https://nodejs.org/ ).
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="install-yarn"></a> Instale Yarn
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Yarn é um gerenciador de pacotes para Node.js. Se você ainda não o instalou, pode fazê-lo seguindo as instruções em [yarnpkg.com ](https://classic.yarnpkg.com/lang/en/docs/install/ ).
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="install-node-dependencies"></a> Instale Dependencias do Node
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Navegue até o diretório do projeto e instale as dependências do Node usando o Yarn:
2024-05-11 22:22:20 +03:00
```bash
cd hydra
yarn
```
2024-05-12 04:23:35 +03:00
### <a name="install-python-39"></a> Instale Python 3.9
2024-05-11 22:22:20 +03:00
2024-05-20 20:58:28 +03:00
Certifique-se de ter o Python 3.9 instalado em sua máquina. Você pode baixá-lo e instalá-lo em [python.org ](https://www.python.org/downloads/release/python-3913/ ).
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="install-python-dependencies"></a> Instale Python Dependencies
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Instale as dependências Python necessárias usando o pip:
2024-05-11 22:22:20 +03:00
```bash
pip install -r requirements.txt
```
2024-05-12 04:23:35 +03:00
## <a name="environment-variables"></a> Environment variables
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Você precisará de uma chave da API SteamGridDB para buscar os ícones do jogo durante a instalação.
Se você deseja ter o onlinefix como um repacker, precisará adicionar suas credenciais ao arquivo .env.
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Depois de obtê-lo, você pode copiar ou renomear o arquivo `.env.example` para `.env` e inserir `STEAMGRIDDB_API_KEY` , `ONLINEFIX_USERNAME` e `ONLINEFIX_PASSWORD` .
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
## <a name="running"></a> Running
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Uma vez que você tenha configurado tudo, você pode executar o seguinte comando para iniciar tanto o processo Electron quanto o cliente BitTorrent:
2024-05-11 22:22:20 +03:00
```bash
yarn dev
```
2024-05-12 04:23:35 +03:00
## <a name="build"></a> Build
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
### <a name="build-the-bittorrent-client"></a> Build the bittorrent client
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Compile o cliente BitTorrent usando este comando
2024-05-11 22:22:20 +03:00
```bash
python torrent-client/setup.py build
```
2024-05-12 04:23:35 +03:00
### <a name="build-the-electron-application"></a> Build the Electron application
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
Compile a aplicação Electron usando este comando:
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
No Windows:
2024-05-11 22:22:20 +03:00
```bash
yarn build:win
```
2024-05-12 04:23:35 +03:00
No Linux:
2024-05-11 22:22:20 +03:00
```bash
yarn build:linux
```
2024-05-12 04:23:35 +03:00
## <a name="contributors"></a> Contributors
2024-05-11 22:22:20 +03:00
< a href = "https://github.com/hydralauncher/hydra/graphs/contributors" >
< img src = "https://contrib.rocks/image?repo=hydralauncher/hydra" / >
< / a >
2024-05-12 04:23:35 +03:00
## <a name="license"></a> Licença
2024-05-11 22:22:20 +03:00
2024-05-12 04:23:35 +03:00
O Hydra é licenciado sob a [Licença MIT ](LICENSE ).