2024-05-06 13:56:33 +03:00
< br >
< div align = "center" >
2024-05-12 00:15:05 +03:00
[<img src="./resources/icon.png" width="144"/> ](https://hydralauncher.site )
2024-05-06 13:56:33 +03:00
< h1 align = "center" > Hydra Launcher< / h1 >
2024-05-12 00:15:05 +03:00
2024-05-06 13:56:33 +03:00
< p align = "center" >
2024-05-10 14:52:52 +03:00
< strong > Hydra - это игровой лаунчер с собственным встроенным клиентом BitTorrent и самостоятельным scraper`ом для репаков.< / strong >
2024-05-06 13:56:33 +03:00
< / p >
2024-05-12 00:15:05 +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 02:46:11 +03:00
[![pt-BR ](https://img.shields.io/badge/lang-pt--BR-green.svg )](README.pt-BR.md)
2024-05-12 00:15:05 +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)
2024-05-12 02:46:11 +03:00
[![uk-UA ](https://img.shields.io/badge/lang-uk--UA-blue )](README.uk-UA.md)
2024-05-11 22:22:20 +03:00
2024-05-12 00:15:05 +03:00
![Hydra Catalogue ](./docs/screenshot.png )
2024-05-06 13:56:33 +03:00
< / div >
## Содержание
2024-05-10 14:52:52 +03:00
- [Описание ](#описание )
- [Особенности ](#особенности )
2024-05-06 13:56:33 +03:00
- [Установка ](#установка )
2024-05-11 22:57:14 +03:00
- [Вклад ](#contributing )
2024-05-11 22:22:20 +03:00
- [Присоединяйтесь к нашему Telegram ](#join-our-telegram )
2024-05-10 14:52:52 +03:00
- [Форк и клонирование репозитория ](#форк-и-клонирование-репозитория )
2024-05-06 13:56:33 +03:00
- [Способы внести свой вклад ](#способы-внести-свой-вклад )
- [Структура проекта ](#структура-проекта )
2024-05-10 14:52:52 +03:00
- [Сборка из исходного кода ](#сборка-из-исходного-кода )
- [Установка Node.js ](#установка-nodejs )
- [Установка Yarn ](#установка-yarn )
- [Установка зависимостей Node ](#установка-зависимостей-node )
- [Установка Python 3.9 ](#установка-python-39 )
- [Установка зависимостей Python ](#установка-зависимостей-python )
2024-05-06 13:56:33 +03:00
- [Переменные среды ](#переменные-среды )
- [Запуск ](#запуск )
2024-05-10 14:52:52 +03:00
- [Сборка ](#сборка )
- [Сборка клиента BitTorrent ](#сборка-клиента-bittorrent )
- [Сборка приложения Electron ](#сборка-приложения-electron )
2024-05-06 13:56:33 +03:00
- [Участники ](#участники )
2024-05-10 14:52:52 +03:00
## Описание
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
**Hydra** - это **Игровой Лаунчер** с собственным встроенным **Клиентом BitTorrent** и **самостоятельным scraper`ом для репаков** .
2024-05-06 13:56:33 +03:00
< br >
2024-05-10 14:52:52 +03:00
Лаунчер написан на TypeScript (Electron) и Python, который управляет системой торрентов с помощью libtorrent.
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
## Особенности
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
- Самостоятельный scraper репаков среди всех наиболее надежных веб-сайтов в [Megathread ](https://www.reddit.com/r/Piracy/wiki/megathread/ )
- Встроенный клиент BitTorrent
- Интеграция How Long To Beat (HLTB) на странице игры
- Настройка пути загрузки
2024-05-06 13:56:33 +03:00
- Уведомления о б обновлении списка репаков
- Поддержка Windows и Linux
- Постоянно обновляется
2024-05-10 14:52:52 +03:00
- И многое другое...
2024-05-06 13:56:33 +03:00
## Установка
2024-05-10 14:52:52 +03:00
Чтобы установить, выполните следующие шаги:
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
1. Скачайте последнюю версию Hydra с [страницы релизов ](https://github.com/hydralauncher/hydra/releases/latest ).
- Загрузите только .exe, если хотите установить Hydra на Windows.
- Загрузите .deb или .rpm или .zip, если хотите установить Hydra на Linux (в зависимости от вашего дистрибутива Linux).
2. Запустите скачанный файл.
3. Наслаждайтесь Hydra!
2024-05-06 13:56:33 +03:00
2024-05-11 22:57:14 +03:00
## <a name="contributing"> Вклад
2024-05-06 13:56:33 +03:00
2024-05-11 22:22:20 +03:00
### <a name="join-our-telegram"></a> Присоединяйтесь к нашему Telegram
2024-05-06 13:56:33 +03:00
2024-05-11 22:22:20 +03:00
Мы сосредотачиваем наши обсуждения в нашем канале [Telegram ](https://t.me/hydralauncher ).
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Форк и клонирование репозитория
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
1. Форкните репозиторий [(нажмите здесь, чтобы сделать форк сейчас) ](https://github.com/hydralauncher/hydra/fork )
2. Склонируйте свой форкнутый код `git clone https://github.com/ва ше _имя_по льзо ва те ля/hydra`
3. Создайте новую ветку
4. Отправьте свои коммиты
5. Отправьте Pull Request
2024-05-06 13:56:33 +03:00
### Способы внести свой вклад
2024-05-10 14:52:52 +03:00
- Перевод: Мы хотим, чтобы Hydra была доступна как можно большему количеству людей. Н е стесняйтесь помогать переводить на новые языки или обновлять и улучшать те, которые уже доступны в Hydra.
2024-05-12 14:45:41 +03:00
- Код: Hydra создан с использованием TypeScript, Electron и немного Python. Если хотите внести свой вклад, присоединяйтесь к нашему каналу [Telegram ](https://t.me/hydralauncher )!
2024-05-06 13:56:33 +03:00
### Структура проекта
2024-05-10 14:52:52 +03:00
- torrent-client: Мы используем libtorrent, библиотеку Python, для управления загрузками торрентов.
- src/renderer: пользовательский интерфейс приложения.
- src/main: весь основной функционал здесь.
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
## Сборка из исходного кода
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Установка Node.js
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Убедитесь, что у вас установлен Node.js на вашем компьютере. Если нет, загрузите и установите е г о с [nodejs.org ](https://nodejs.org/ ).
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Установка Yarn
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Yarn - менеджер пакетов для Node.js. Если вы еще не установили Yarn, сделайте это, следуя инструкциям на [yarnpkg.com ](https://classic.yarnpkg.com/lang/en/docs/install/ ).
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Установка зависимостей Node
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Перейдите в каталог проекта и установите зависимости Node, используя Yarn:
2024-05-06 13:56:33 +03:00
```bash
cd hydra
yarn
```
2024-05-10 14:52:52 +03:00
### Установка Python 3.9
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Убедитесь, что у вас установлен Python 3.9 на вашем компьютере. Вы можете загрузить и установить е г о с [python.org ](https://www.python.org/downloads/release/python-3919/ ).
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Установка зависимостей Python
2024-05-06 13:56:33 +03:00
Установите необходимые зависимости Python, используя pip:
```bash
pip install -r requirements.txt
```
## Переменные среды
2024-05-10 14:52:52 +03:00
Вам понадобится ключ API SteamGridDB, чтобы получить значки игр при установке.
Если вы хотите использовать onlinefix в качестве репака, вам нужно добавить ваши учетные данные в файл .env.
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Как только у вас будет ключ, вы можете скопировать или переименовать файл `.env.example` в `.env` и поместить в него `STEAMGRIDDB_API_KEY` , `ONLINEFIX_USERNAME` , `ONLINEFIX_PASSWORD` .
2024-05-06 13:56:33 +03:00
## Запуск
2024-05-10 14:52:52 +03:00
После того как все настроено, вы можете выполнить следующую команду, чтобы запустить процесс Electron и клиента BitTorrent:
2024-05-06 13:56:33 +03:00
```bash
yarn dev
```
2024-05-10 14:52:52 +03:00
## Сборка
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
### Сборка клиента BitTorrent
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Соберите клиент BitTorrent с помощью этой команды:
2024-05-06 13:56:33 +03:00
```bash
python torrent-client/setup.py build
```
2024-05-10 14:52:52 +03:00
### Сборка приложения Electron
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Соберите приложение Electron, используя эту команду:
2024-05-06 13:56:33 +03:00
2024-05-10 14:52:52 +03:00
Н а Windows:
2024-05-06 13:56:33 +03:00
```bash
yarn build:win
```
2024-05-10 14:52:52 +03:00
Н а Linux:
2024-05-06 13:56:33 +03:00
```bash
yarn build:linux
```
## Участники
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-06 13:56:33 +03:00
## License
2024-05-10 14:52:52 +03:00
Hydra лицензирована в соответствии с [MIT License ](LICENSE ).