Содержание

RSS рассылки

RSS рассылки

Что это?

Рассылки RSS служат для получения ленты новостей, в том числе списка новых раздач. Загружать в сидбокс полученные по RSS торренты можно как вручную, так и автоматически.

Как добавить новую RSS рассылку

Многие трекеры предоставляют несколько RSS. Будьте внимательны, выбирайте правильную ленту – с раздачами!

На примере rutracker.org:

В контекстном меню ПКМ пункта «Все рассылки» выбрать Добавить рассылку
Скопировать URL рассылки с трекера и указать название (например rutracker)
Появится список последних раздач

Теперь можно добавлять торренты из списка (ПКМ и выбрать Загрузить) вручную – или же настроить их автоматическую загрузку.

Не все рассылки предоставляют корректную ссылку для загрузки торрента!
В таком случае необходимо создать правило коррекции URL (см. ниже)

Как настроить автоматическую загрузку

Проверим интервал обновления рассылок – в настройках сидбокса в разделе Рассылки установите нужное значение (в минутах)
Если трекер требует авторизации – укажите логин и пароль в настройках в разделе Аккаунты. Если нужного трекера там нет, используйте Cookies (см. ниже)
В контекстном меню списка раздач выберите Менеджер рассылок
- Добавьте новое правило – Добавить и дайте ему понятное имя
- В поле Фильтр введите регулярное выражение (см. ниже), которому будут соответствовать нужные раздачи
- Поле Кроме (тоже регулярное выражение) – исключить что-либо из совпадений (заполнять необязательно)
  - Искать в названии – включить в поиск название раздачи (по умолчанию)
  - Искать в описании – включить в поиск текст страницы раздачи
  - Искать в ссылке – включить в поиск URL раздачи
- Рассылка – выберите нужную
- Директория – если планируется загружать торренты из нескольких рассылок, имеет смысл выделить для каждой свою папку
  - не добавлять имя торрента к пути – подробное описание тут
  - не начинать закачку автоматически – торренты будут добавлены, но в остановленном состоянии
- Min интервал – как часто торренты будут добавляться из рассылки (если не нужно, чтобы это происходило немедленно)
- Метка – рекомендуется заполнить, особенно если Директория была оставлена пустой

После нажатия Ок раздачи из списка выбранной Рассылки будут немедленно загружены. Новые раздачи, соответствующие Фильтру созданного правила, будут загружаться в соответствии с интервалом обновления рассылок.

На скриншоте все раздачи в состоянии «Остановлено». Мы не планировали загружать десятки гигабайтов исключительно в иллюстративных целях, поэтому при создании правила выбрали не начинать закачку автоматически. В реальных условиях все эти торренты были бы скачаны и активны.

Регулярные выражения

Что это такое?

Регулярные выражения используются для поиска совпадения в строках.
К примеру, нужно автоматически загружать все торренты сериала «Ходячие мертвецы» из рассылки RSS. Для этого можно использовать следующее выражение:

/The Walking Dead.*Сезон:/i

Регулярное выражение в общем виде записывается как /строка/флаги. Мы будем использовать флаги i и u.
i означает нечувствительность к регистру, то есть а и А считаются одинаковыми символами.
u – unicode, без этого русские буквы не будут считаться частью слова.

. означает «любой символ», * – «любое количество». .* – любое к-во любых символов.

В регулярных выражениях используются и другие специальные символы: ^ $ + ? { } [ ] \ | ( ) и иногда нужно, чтобы они интерпретировались как «обычные» – для этого используется экранирование символом \ (обратный слэш), например:
1*2 означает «любое к-во 1, потом 2», в то время как 1\*2 будет соответствовать строке 1*2.

Если регулярное выражение записывается как /строка/i, то слэш / тоже является специальным символом.
Для использования в /строке/i его тоже надо экранировать: /https?:\/\/domain\.tld\/\S/i.
Здесь s? означает «s либо ничего», а для того, чтобы . в domain.tld интерпретировалась именно как точка, а не как «любой символ», она экранирована: \.
\S – любой символ, не являющийся пробелом

Это выражение соответствует любому http или https URL для domain.tld c непустым путем, например http://domain.tld/wiki/ или https://domain.tld/images/photo.png.

Если выражение должно содержать слэш, то, чтобы избежать громоздкого экранирования, его можно записать иначе: %выражение%i или #выражение#i,
тогда предыдущее выражение будет выглядеть так: #https?://domain\.tld/\S#i

Вернемся к «Ходячим мертвецам». Выражение /The Walking Dead.*Сезон:/i «найдет» все нужные торренты, однако оно совпадет и с другим сериалом Бойтесь ходячих мертвецов / Fear the Walking Dead / Сезон: 7, что уже не очень хорошо. Можно, конечно, добавить в регулярное выражение и русское название, но мы ведь не ищем легких путей? На самом деле иногда бывает несколько вариантов перевода, так что правильнее ограничиться оригинальным названием.

Оригинальное название заключено между слэшами с пробелами – / The Walking Dead /. Учтем тот факт, что с релизер может ошибиться с пробелами (пропустить или использовать 2+ пробела), так что используем специальный символ * («любое количество»):
/ *The Walking Dead */ *Сезон:. Чтобы не экранировать слэши, используем в качестве ограничителей #, и в итоге получится #/ *The Walking Dead */ *Сезон:#i

Немного усложним задачу –- мы не хотим скачивать большие раздачи всех сезонов этого сериала, так что мы должны исправить выражение так, чтобы оно не совпадало со строкой Ходячие мертвецы / The Walking Dead / Сезон: 1-10 из 10 / Серии: 1-153 из 153.
Проанализируем «правильную» подстроку … Сезон: 11 / Серии … – в ней после слова Сезон идет номер сезона и слэш. Учитывая, что \d означает «любая десятичная цифра», а + – «один или больше», запишем:

#/ *The Walking Dead */ *Сезон: *\d+ */#i

Еще один пример – выборка всех раздач футбола в хорошем качестве на русском или английском языке. Пример названия такой раздачи:
Чемпионат Нидерландов. Eredivisie 2022-2023 / 4-й тур / Утрехт (Утрехт) - Аякс (Амстердам) / Setanta Sports 1 HD [28.08.2022, Футбол, IPTV/1080i/25fps, TS/H.264, RU-EN]

Нам понадобятся следующие конструкции:

\b – «граница слова». Словом считается все, состоящее из букв, цифр и подчеркивания
[abcd…] – любой из символов abcd…
(яблоко|груша|персик) – любое из слов яблоко, груша, персик

Соберем всё это вместе.

Хорошим качеством мы сочтем разрешение в 1080 (это 1080i и 1080p), так что учтем оба варианта: 1080[ip]
Русский и английский пишутся как RU и EN, но встречается и RUS / ENG – это будет (RUS?|ENG?)
Напоминаем, что S? означает «S либо ничего», то есть RUS? соответствуют и RUS и RU
C разделителями и пробелами могут быть разные варианты, так что будем использовать «границу слова» – \b
Для правильной работы \b с русскими буквами нужен флаг u
Слэшей у нас нет, так что используем стандартные ограничители /

/Футбол\b.*\b1080[ip]\b.*\b(RUS?|ENG?)\b/iu

По умолчанию регулярное выражение может соответствовать любой части строки. Если нужно «привязаться» к её началу и/или концу, используйте ^ и $

/^начало…конец$/i «найдется» в Начало закончилось, начался конец, но не в Что-то началось, но конец еще не близок

Конечно же, мы рассмотрели только очень малую часть синтаксиса регулярных выражений. Надеемся, что для задач выборки по названиям раздач этого достаточно. Если же нет – читайте официальную документацию здесь и здесь (надеемся, что до этого дело не дойдет ).
Или же загуглите «регулярные выражения для начинающих», но букв там будет еще больше.

Здесь можно (и нужно) протестировать регулярное выражение перед тем, как включать на загрузку соответствующее RSS-правило. Выбирайте Flavor PCRE и не забывайте флаги.

Если будут сложности – обратитесь в нашу поддержку (контакты внизу страницы)

Правила коррекции URL

Зачем это нужно?

Некоторые рассылки не предоставляют правильную ссылку для скачивания торрента, однако ее можно создать из URL описания (или URL загрузки).

Как это работает

Рассмотрим на примере rutracker.org. В их рассылке вместо URL для скачивания торрента есть ссылка на тему раздачи (URL описания):

https://rutracker.org/forum/viewtopic.php?t=NUMBER, где NUMBER – номер раздачи.
Правильная ссылка для скачивания (URL загрузки) будет такой: https://rutracker.org/forum/dl.php?t=NUMBER

Превратить одно в другое можно с помощью регулярных выражений (см. выше) примерно таким образом:

создадим выражение для захвата нужных частей строки из URL описания:
- протокола – (https?://) (чтобы ничего не сломалось, если протокол изменится)
- суффикса домена rutracker – (org|net) (если придется переходить с одного зеркала на другое)
- собственно номера раздачи – (\d+)
  Скобки () означают, что мы «захватываем» часть строки, чтобы в дальнейшем ее использовать. Тогда ${1} будет означать «содержимое 1-ой пары скобок», ${2} – второй и т.д.
- соберем всё вместе: #(https?://)rutracker\.(org|net)/forum/viewtopic\.php\?t=(\d+)#i
создадим шаблон для создания URL загрузки:
- ${1}rutracker.${2}/forum/dl.php?t=${3}
  Это не регулярное выражение; просто строка, в которой ${N} будет заменено на захваченное содержимое N-ной пары скобок
создадим новое правило в Менеджере правил:

Как настроить

В контекстном меню списка раздач (или в контекстном меню любой рассылки) выберите Менеджер правил
Добавьте новое правило – Добавить и дайте ему понятное имя
В списке Параметры правила выберите «Если URL описания торрента совпадает с шаблоном»
В поле под списком впишите созданное выше регулярное выражение для захвата из URL описания:
#(https?://)rutracker\.(org|net)/forum/viewtopic\.php\?t=(\d+)#i
В списке ниже выберите «заменить URL загрузки на»
В поле под списком впишите созданный выше шаблон:
${1}rutracker.${2}/forum/dl.php?t=${3}
В поле Рассылка выберите «Все рассылки» (поскольку наше правило относится к трекеру, а не к определенной рассылке; рассылки с других трекеров не будут соответствовать регулярному выражению и будут пропущены этим правилом)

После нажатия ОК все новые торренты с рассылок rutracker будут автозагружаться с правильных ссылок.