hydra/README.ru.md

188 lines
8.9 KiB
Markdown
Raw Normal View History

2024-05-06 13:56:33 +03:00
<br>
<div align="center">
2024-05-13 02:54:48 +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-09-09 19:03:33 +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-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-19 21:35:59 +03:00
[![pt-BR](https://img.shields.io/badge/lang-pt--BR-green.svg)](README.pt-BR.md)
[![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-13 02:54:48 +03:00
[![uk-UA](https://img.shields.io/badge/lang-uk--UA-blue)](README.uk-UA.md)
[![be](https://img.shields.io/badge/lang-be-orange)](README.be.md)
[![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)
[![ita](https://img.shields.io/badge/lang-it-red)](README.it.md)
2024-05-13 02:54:48 +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-09-10 02:57:01 +03:00
- [Вклад](#-вклад)
- [Присоединяйтесь к нашему Telegram](#-присоединяйтесь-к-нашему-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
- [Участники](#участники)
- [License](#license)
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).
2024-05-13 02:54:48 +03:00
- Загрузите только .exe, если хотите установить Hydra на Windows.
- Загрузите .deb или .rpm или .zip, если хотите установить Hydra на Linux (в зависимости от вашего дистрибутива Linux).
2024-05-10 14:52:52 +03:00
2. Запустите скачанный файл.
3. Наслаждайтесь Hydra!
2024-05-06 13:56:33 +03:00
## <a name="contributing"> Вклад
2024-05-06 13:56:33 +03:00
### <a name="join-our-telegram"></a> Присоединяйтесь к нашему Telegram
2024-05-06 13:56:33 +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-20 20:58:28 +03:00
Убедитесь, что у вас установлен Python 3.9 на вашем компьютере. Вы можете загрузить и установить его с [python.org](https://www.python.org/downloads/release/python-3913/).
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
```
## Участники
<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).