86 lines
7.2 KiB
Markdown
86 lines
7.2 KiB
Markdown
# NNM-Club Uploaders Tools
|
||
|
||
Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club.
|
||
Использование данной программы разрешено только при соблюдении правил торрент-трекера, и автор не несёт ответственнои за
|
||
нецелевое или вредоносное использование данного исходного кода!
|
||
|
||
## Как использовать GUI-версию
|
||
|
||
GUI для данной программы отсутстует.
|
||
|
||
## Как использовать консольную версию
|
||
|
||
Для начала, скопируйте файл `massdl`/`massdl.exe` из директории, соответствующей вашей операционной системе и
|
||
архитектуре процессора в папку, в которой вы планируете запускать программу, после чего откройте программу командной
|
||
строки.
|
||
|
||
- Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal
|
||
- Для Linux — терминал из поставки вашего DE, или же просто голая консоль
|
||
- Для macOS — Terminal.app или iTerm2
|
||
|
||
Перейдите в папку, в которой у вас появился файл `massdl` (или `massdl.exe` в случае Windows). Обычно для перехода в
|
||
папку нужно выполнить команду `cd /путь/к/папке/` (или `cd буква_диска:\путь\к\папке` в случае Windows).
|
||
|
||
Любые дальнейшие действия предполагают, что вы находитесь в терминале, в котором открыта папка с файлом `massdl`
|
||
/`massdl.exe`.
|
||
|
||
### Авторизация в NNM-Club
|
||
|
||
Прежде всего, нам необходимо сконфигурировать программу. Для этого запустите `./massdl -auth`
|
||
|
||
Приложение попросит вас последовательно ввести следующие данные:
|
||
|
||
- Домен NNM-Club: текущий домен, на котором работает форум.
|
||
- Имя пользователя: ваше имя пользователя.
|
||
- Пароль: ваш пароль.
|
||
|
||
После ввода всех данных приложение попробует авторизоваться на сайте, и сообщит, смогло ли оно это сделать. Если оно не
|
||
смогло войти на сайт — повторите запуск `./massdl -auth`, убедившись, что вы вводите правильный пароль, а сервер форума
|
||
доступен для связи (иногда для стабильного соединения нужен VPN).
|
||
|
||
После успешного логина можно приступать к скачиванию торрент-файлов.
|
||
|
||
### Скачивание торрентов
|
||
|
||
Для скачивания торрентов запустите команду `./massdl -forum <номер_форума>`, в которой `<номер_форума>` — число без
|
||
кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native \*Nix Games", чей
|
||
адрес https://nnmclub.ro/forum/viewforum.php?f=1193, номер форума равен 1193.
|
||
|
||
Расширенная опция `-outputDir` позволяет указать конкретную папку, в которой будет создана папка с торрент-файлами. По
|
||
умолчанию папка с торрент-файлами создаётся рядом с файлом `massdl`/`massdl.exe`.
|
||
|
||
Пример: чтобы скачать форум "Native \*Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу
|
||
следует вызвать следующим образом:
|
||
|
||
```sh
|
||
./massdl -forum 1193 -outputDir C:\Users\MyUsername\Desktop
|
||
```
|
||
|
||
## Особенности работы программы
|
||
|
||
Для любой версии этой программы верны следующие особенности:
|
||
|
||
- Программа работает по методу best effort: к сожалению, так как в её основе парсинг HTML, нет 100% гарантии, что будут
|
||
скачаны все торрент-файлы. Однако, даётся гарантия, что будут обнаружены все топики указанного форума, и в логах можно
|
||
будет посмотреть, с какими из них возникли проблемы.
|
||
- При сетевых ошибках программа пытается повторить запрос 5 раз, после чего прекращает попытки.
|
||
- Вне зависимости от указанного пути сохранения торрентов будет создана поддиректория с названием, равным номеру форума,
|
||
в которой будут лежать все торренты.
|
||
- Торренты в директории сортируются по дате последнего обновления.
|
||
- Топики, не проверенные модераторами, игнорируются.
|
||
- Подфорумы игнорируются — для них следует запускать программу ещё раз с номером подфорума.
|
||
- Скачивание нескольких форумов за раз не поддерживается.
|
||
- К сожалению, пока что логи не сохраняются на диск.
|
||
- В конце работы показывается суммарный объём свободного места на жёстком диске, который необходим для скачивания всех
|
||
торрентов, полученных в ходе сеанса работы программы.
|
||
|
||
Указанные выше особенности могут быть исправлены/пересмотрены в будущем.
|
||
|
||
## Багрепортинг и фичреквестинг
|
||
|
||
Единственное место, где принимаются сообщения об ошибках в программе и пожелания по её улучшению — топик на форуме
|
||
NNM-Club. Подобные запросы в личные сообщения форума, в трекер Issues исходного кода и так далее будут игнорироваться, а за пределами форума — приводить к потере
|
||
возможности коммуницировать с автором.
|
||
|
||
На данный момент поддержка тулзы осуществляется по методу best effort и не гарантируется.
|