Open source the tool
This commit is contained in:
parent
3a821f3945
commit
01781f727f
GPG Key ID:
673980B6882F82C6
25
LICENSE
25
LICENSE
@ -1,4 +1,21 @@
|
||||
Copyright (c) 2012-2022 Vladimir "fat0troll" Hodakov
|
||||
All Rights Reserved.
|
||||
Unauthorized copying of this file, via any medium is strictly prohibited.
|
||||
Proprietary and confidential.
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2012-2025 Vladimir Hodakov
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
48
USAGE.md
48
USAGE.md
@ -1,12 +1,12 @@
|
||||
# NNM-Club Uploaders Tools
|
||||
|
||||
Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club. Использование этой программы
|
||||
разрешено только действующим участникам релиз-группы Uploaders. Если вы не принадлежите к их числу, удалите программу
|
||||
немедленно!
|
||||
Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club.
|
||||
Использование данной программы разрешено только при соблюдении правил торрент-трекера, и автор не несёт ответственнои за
|
||||
нецелевое или вредоносное использование данного исходного кода!
|
||||
|
||||
## Как использовать GUI-версию
|
||||
|
||||
GUI для данной программы пока отсутствует, но планируется до конца года.
|
||||
GUI для данной программы отсутстует.
|
||||
|
||||
## Как использовать консольную версию
|
||||
|
||||
@ -14,9 +14,9 @@ GUI для данной программы пока отсутствует, но
|
||||
архитектуре процессора в папку, в которой вы планируете запускать программу, после чего откройте программу командной
|
||||
строки.
|
||||
|
||||
* Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal
|
||||
* Для Linux — терминал из поставки вашего DE, или же просто голая консоль
|
||||
* Для macOS — Terminal.app или iTerm2
|
||||
- Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal
|
||||
- Для Linux — терминал из поставки вашего DE, или же просто голая консоль
|
||||
- Для macOS — Terminal.app или iTerm2
|
||||
|
||||
Перейдите в папку, в которой у вас появился файл `massdl` (или `massdl.exe` в случае Windows). Обычно для перехода в
|
||||
папку нужно выполнить команду `cd /путь/к/папке/` (или `cd буква_диска:\путь\к\папке` в случае Windows).
|
||||
@ -30,9 +30,9 @@ GUI для данной программы пока отсутствует, но
|
||||
|
||||
Приложение попросит вас последовательно ввести следующие данные:
|
||||
|
||||
* Домен NNM-Club: текущий домен, на котором работает форум.
|
||||
* Имя пользователя: ваше имя пользователя.
|
||||
* Пароль: ваш пароль.
|
||||
- Домен NNM-Club: текущий домен, на котором работает форум.
|
||||
- Имя пользователя: ваше имя пользователя.
|
||||
- Пароль: ваш пароль.
|
||||
|
||||
После ввода всех данных приложение попробует авторизоваться на сайте, и сообщит, смогло ли оно это сделать. Если оно не
|
||||
смогло войти на сайт — повторите запуск `./massdl -auth`, убедившись, что вы вводите правильный пароль, а сервер форума
|
||||
@ -43,13 +43,13 @@ GUI для данной программы пока отсутствует, но
|
||||
### Скачивание торрентов
|
||||
|
||||
Для скачивания торрентов запустите команду `./massdl -forum <номер_форума>`, в которой `<номер_форума>` — число без
|
||||
кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native *Nix Games", чей
|
||||
кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native \*Nix Games", чей
|
||||
адрес https://nnmclub.ro/forum/viewforum.php?f=1193, номер форума равен 1193.
|
||||
|
||||
Расширенная опция `-outputDir` позволяет указать конкретную папку, в которой будет создана папка с торрент-файлами. По
|
||||
умолчанию папка с торрент-файлами создаётся рядом с файлом `massdl`/`massdl.exe`.
|
||||
|
||||
Пример: чтобы скачать форум "Native *Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу
|
||||
Пример: чтобы скачать форум "Native \*Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу
|
||||
следует вызвать следующим образом:
|
||||
|
||||
```sh
|
||||
@ -60,18 +60,18 @@ GUI для данной программы пока отсутствует, но
|
||||
|
||||
Для любой версии этой программы верны следующие особенности:
|
||||
|
||||
* Программа работает по методу best effort: к сожалению, так как в её основе парсинг HTML, нет 100% гарантии, что будут
|
||||
- Программа работает по методу best effort: к сожалению, так как в её основе парсинг HTML, нет 100% гарантии, что будут
|
||||
скачаны все торрент-файлы. Однако, даётся гарантия, что будут обнаружены все топики указанного форума, и в логах можно
|
||||
будет посмотреть, с какими из них возникли проблемы.
|
||||
* При сетевых ошибках программа пытается повторить запрос 5 раз, после чего прекращает попытки.
|
||||
* Вне зависимости от указанного пути сохранения торрентов будет создана поддиректория с названием, равным номеру форума,
|
||||
- При сетевых ошибках программа пытается повторить запрос 5 раз, после чего прекращает попытки.
|
||||
- Вне зависимости от указанного пути сохранения торрентов будет создана поддиректория с названием, равным номеру форума,
|
||||
в которой будут лежать все торренты.
|
||||
* Торренты в директории сортируются по дате последнего обновления.
|
||||
* Топики, не проверенные модераторами, игнорируются.
|
||||
* Подфорумы игнорируются — для них следует запускать программу ещё раз с номером подфорума.
|
||||
* Скачивание нескольких форумов за раз не поддерживается.
|
||||
* К сожалению, пока что логи не сохраняются на диск.
|
||||
* В конце работы показывается суммарный объём свободного места на жёстком диске, который необходим для скачивания всех
|
||||
- Торренты в директории сортируются по дате последнего обновления.
|
||||
- Топики, не проверенные модераторами, игнорируются.
|
||||
- Подфорумы игнорируются — для них следует запускать программу ещё раз с номером подфорума.
|
||||
- Скачивание нескольких форумов за раз не поддерживается.
|
||||
- К сожалению, пока что логи не сохраняются на диск.
|
||||
- В конце работы показывается суммарный объём свободного места на жёстком диске, который необходим для скачивания всех
|
||||
торрентов, полученных в ходе сеанса работы программы.
|
||||
|
||||
Указанные выше особенности могут быть исправлены/пересмотрены в будущем.
|
||||
@ -79,5 +79,7 @@ GUI для данной программы пока отсутствует, но
|
||||
## Багрепортинг и фичреквестинг
|
||||
|
||||
Единственное место, где принимаются сообщения об ошибках в программе и пожелания по её улучшению — топик на форуме
|
||||
NNM-Club. Подобные запросы в личные сообщения форума будут игнорироваться, а за пределами форума — приводить к потере
|
||||
возможности коммуницировать с автором. Автор обязуется обрабатывать сообщения в теме форума хотя бы раз в месяц.
|
||||
NNM-Club. Подобные запросы в личные сообщения форума, в трекер Issues исходного кода и так далее будут игнорироваться, а за пределами форума — приводить к потере
|
||||
возможности коммуницировать с автором.
|
||||
|
||||
На данный момент поддержка тулзы осуществляется по методу best effort и не гарантируется.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user