hdkv/uploader_tools
1
Fork 0
Code Releases Activity

Open source the tool

Browse Source
This commit is contained in:
Vladimir Hodakov 2025-04-17 14:14:36 +04:00
parent 3a821f3945
commit 01781f727f
Signed by: Vladimir Hodakov
GPG Key ID: 673980B6882F82C6
3 changed files with 47 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
LICENSE
View File

@ -1,4 +1,21 @@
Copyright (c) 2012-2022 Vladimir "fat0troll" Hodakov MIT License
All Rights Reserved.
Unauthorized copying of this file, via any medium is strictly prohibited. Copyright (c) 2012-2025 Vladimir Hodakov
Proprietary and confidential.
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
View File

@ -1,12 +1,12 @@
# NNM-Club Uploaders Tools # NNM-Club Uploaders Tools
Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club. Использование этой программы Данная программа предназначена для загрузки торрент-файлов из разделов форума NNM-Club.
разрешено только действующим участникам релиз-группы Uploaders. Если вы не принадлежите к их числу, удалите программу Использование данной программы разрешено только при соблюдении правил торрент-трекера, и автор не несёт ответственнои за
немедленно! нецелевое или вредоносное использование данного исходного кода!
## Как использовать GUI-версию ## Как использовать GUI-версию
GUI для данной программы пока отсутствует, но планируется до конца года. GUI для данной программы отсутстует.
## Как использовать консольную версию ## Как использовать консольную версию
@ -14,9 +14,9 @@ GUI для данной программы пока отсутствует, но
архитектуре процессора в папку, в которой вы планируете запускать программу, после чего откройте программу командной архитектуре процессора в папку, в которой вы планируете запускать программу, после чего откройте программу командной
строки. строки.
* Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal - Для Windows это может быть cmd.exe, Windows PowerShell или Windows Terminal
* Для Linux — терминал из поставки вашего DE, или же просто голая консоль - Для Linux — терминал из поставки вашего DE, или же просто голая консоль
* Для macOS — Terminal.app или iTerm2 - Для macOS — Terminal.app или iTerm2
Перейдите в папку, в которой у вас появился файл `massdl` (или `massdl.exe` в случае Windows). Обычно для перехода в Перейдите в папку, в которой у вас появился файл `massdl` (или `massdl.exe` в случае Windows). Обычно для перехода в
папку нужно выполнить команду `cd /путь/к/папке/` (или `cd буква_диска:\путь\к\папке` в случае Windows). папку нужно выполнить команду `cd /путь/к/папке/` (или `cd буква_диска:\путь\к\папке` в случае Windows).
@ -30,9 +30,9 @@ GUI для данной программы пока отсутствует, но
Приложение попросит вас последовательно ввести следующие данные: Приложение попросит вас последовательно ввести следующие данные:
* Домен NNM-Club: текущий домен, на котором работает форум. - Домен NNM-Club: текущий домен, на котором работает форум.
* Имя пользователя: ваше имя пользователя. - Имя пользователя: ваше имя пользователя.
* Пароль: ваш пароль. - Пароль: ваш пароль.
После ввода всех данных приложение попробует авторизоваться на сайте, и сообщит, смогло ли оно это сделать. Если оно не После ввода всех данных приложение попробует авторизоваться на сайте, и сообщит, смогло ли оно это сделать. Если оно не
смогло войти на сайт — повторите запуск `./massdl -auth`, убедившись, что вы вводите правильный пароль, а сервер форума смогло войти на сайт — повторите запуск `./massdl -auth`, убедившись, что вы вводите правильный пароль, а сервер форума
@ -43,13 +43,13 @@ GUI для данной программы пока отсутствует, но
### Скачивание торрентов ### Скачивание торрентов
Для скачивания торрентов запустите команду `./massdl -forum <номер_форума>`, в которой `<номер_форума>` — число без Для скачивания торрентов запустите команду `./massdl -forum <номер_форума>`, в которой `<номер_форума>` — число без
кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native *Nix Games", чей кавычек, которое видно в адресной строке, если открыть этот форум. К примеру, для форума "Native \*Nix Games", чей
адрес https://nnmclub.ro/forum/viewforum.php?f=1193, номер форума равен 1193. адрес https://nnmclub.ro/forum/viewforum.php?f=1193, номер форума равен 1193.
Расширенная опция `-outputDir` позволяет указать конкретную папку, в которой будет создана папка с торрент-файлами. По Расширенная опция `-outputDir` позволяет указать конкретную папку, в которой будет создана папка с торрент-файлами. По
умолчанию папка с торрент-файлами создаётся рядом с файлом `massdl`/`massdl.exe`. умолчанию папка с торрент-файлами создаётся рядом с файлом `massdl`/`massdl.exe`.
Пример: чтобы скачать форум "Native *Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу Пример: чтобы скачать форум "Native \*Nix Games", а торрент-файлы из него появились на рабочем столе в Windows, программу
следует вызвать следующим образом: следует вызвать следующим образом:
```sh ```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 и не гарантируется.

2
go.mod
View File

@ -1,6 +1,6 @@
module lab.hodakov.me/fat0troll/uploader_tools module lab.hodakov.me/fat0troll/uploader_tools
go 1.17 go 1.24
require ( require (
github.com/PuerkitoBio/goquery v1.5.0 github.com/PuerkitoBio/goquery v1.5.0