TorrentLassoBot: Инструкция по использованию
Краткое описание возможностей:
Бот для автоматизации поиска информации на Torrent-трекерах и загрузки данных через TransmissionBt.
Основные возможности:
- Поиск информации на Torrent-трекерах: rutracker.org, rutor.org, kinozal.tv, напишите, через команду /feedback если хотите какой-то ещё;
- Подписка на изменение и оповещение при изменении выбранных раздач;
- Автоматическая загрузка найденных Torrent-фалов в заданную папку через TransmissionBt вашего сервера;
- Регулярная проверка работоспособности вашего(их) TransmissionBt (ping) и оповещение при (не)доступности.
Основная схема функционирования:
Полезные ссылки
Первый запуск и настройка:
При первом запуске, бот отправит вам сообщение с краткой информацией, ссылкой на эту инструкцию, а также вы сможете увидеть (и выполнить) команды по добавлению TransmissionBt серверов /setServers и данных для авторизации на Torrent-трекерах /setTrackers.
Для начала, нажмите на команду /setServers и подготовьте JSON файл с конфигурацией (в следующих версиях будет доступен web-конфигуратор) по следующей схеме:
[
{
"host":"yourserver.com",
"port":9091,
"proto":"http",
"user":"ivan",
"password":"12345",
"folders":[
{
"name":"TV Shows",
"path":"/downloads/current/tvshows"
}
]
}
]
Вставьте текст в сообщение, если вы не допустили ошибок, конфигурация будет применена, вновь отобразится приветсвенное сообшение, но уже с вашим TransmissionBt сервером(ами):
Далее, опционально, возможно указать логин и пароль для ruTracker.org (в противном случае, поиск будет производиться только по ruTor.org) используя команду /setTrackers, необходимо подготовить JSON файл с конфигурацией (в следующих версиях будет доступен web-конфигуратор) по следующей схеме:
[
{
"id":"rutr",
"login":"ivan",
"password":"12345"
}
]
Вставьте текст в сообщение, если вы не допустили ошибок, конфигурация будет применена, вновь отобразится приветственное сообщение, но уже с вашим логином для ruTracker.org.
Настройка завершена, вы всегда можете посмотреть и изменить настройки используя команды /info или /start.
Также рекомендуется после окончания настройки, очистить историю, чтобы не сохранять пароли в открытом текстовом доступе.
Основные команды:
Поиск: просто отправьте боту "текст запроса" или команду "/search Текст запроса" - произойдет поиск по ключевой фразе по всем torrent-трекерам, которые поддерживает бот. Результаты поиска будут выданы в отсорнированном по убыванию сидов списке. Для осуществления более точного поиска лучше указывать уникальные параметры (год, режисер, версия и т.п.), например для поиска фильма "Такси" 1998 года, лучше написать:
Далее, возможно фильтровать результаты например по качеству "720p" и перемещаться по другим страницам результатов поиска.
Когда выберите необходимую загрузку, нажмите на служебную команду, например /aboutrutr4419166 и бот загрузит подробную информацию о загрузке:
Из этого сообщения возможно выполнить 2 сгенерированные команды:
Загрузить выбранный Torrent с помощью TransmissionBt - /dwnldrutr4419166, в результате появится сообщение со следующим диалогом:
и после выбора места загрузки, бот будет отображать статус скачивания:
и/или выбрать подписку (актуально если Torrent далее будет изменяться, например в раздаче сериала добавляться новые серии) - /watchrutr4419166, после выполнения этой команды будет выполнена подписка на мониторинг изменения Torrent'а:
Команда мониторнг: /watch - отображает список раздач, на которые выполнена подписка:
Из этого же сообщения можно отписаться от мониторинга подписки с помощь нажатия на команду /unwatchrutr4419166.
Служебные, автоматически генерируемые, команды:
/about([a-z0-9]{4})(.+) - команда которую генерирует сам бот, она включает в себя 3 составляющих: саму команду about - показать детальную информацию о загрузке, идентификатор, rutr - торрент-трекера из 4-х символов, 5459895 - ссылку внутри самого трекера. Все вместе может выглядеть вот так: /aboutrutr5459895.
/down([a-z0-9]{4})(.+) - синтаксис аналогичен, команде /about([a-z0-9]{4})(.+), но сама команда down выполнят загрузку торрент-файла с трекера и отправку его в чат, с запросом места его загрузки.
/watch([a-z0-9]{4})(.+) - синтаксис аналогичен, команде /about([a-z0-9]{4})(.+), но сама команда watch выполнят подписку мониторинг изменений торрент-файла на трекере.
/unwatch([a-z0-9]{4})(.+) - синтаксис аналогичен, команде /about([a-z0-9]{4})(.+), но сама команда unwatch позволяет отписаться от мониторинга изменений торрент-файла на трекере.