Завантажувачі

Підключи свій застосунок для завантаження, щоб HolyArrs надсилав йому релізи й імпортував те, що завантажилось.

HolyArrs сам нічого не завантажує. Він передає кожен реліз завантажувачу, стежить за ним і імпортує файли.

Тип	Застосунки
Торент	qBittorrent, Transmission 4 або новіший, Deluge
Usenet	SABnzbd, NZBGet

Перш ніж почати

• Ти власник або адмін.
• Твій застосунок для завантаження запущений, і ти можеш відкрити його вебсторінку.

Додати завантажувач

1. Відкрий Settings > Downloaders (налаштування > завантажувачі).

2. Натисни Add a Downloader (додати завантажувач).

3. У полі Which app (який застосунок) обери свій застосунок.

4. Введи Name (назва).

5. Введи Address (адреса): вебсторінку застосунку, наприклад http://192.168.1.10:8090.

6. Заповни дані для входу. Див. Вхід для кожного застосунку.

7. Натисни Save (зберегти), а потім Test (перевірити) у рядку.

   Біля назви ти маєш побачити Working (працює).

Обережно

Якщо HolyArrs і завантажувач працюють у різних контейнерах і бачать теку завантажень за різними шляхами, імпорт не вдасться. Перед першим завантаженням заповни пару шляхів у розділі Шляхи.

Вхід для кожного застосунку

Застосунок	Що ввести	Де знайти
qBittorrent	API key (API-ключ) (qBittorrent 5.2 або новіший) чи Username and password (ім’я користувача й пароль)	Options > Web UI
Transmission	Ім’я користувача й пароль; порожні, якщо воно їх не просить	Налаштування Transmission
Deluge	Пароль Web UI, без імені користувача	Deluge Web UI
SABnzbd	API-ключ	Config > General
NZBGet	Ім’я користувача й пароль; порожні, якщо NZBGet пускає HolyArrs без них	Налаштування NZBGet

HolyArrs зберігає ключі й паролі зашифрованими та більше їх не показує. Не чіпай поле, щоб залишити збережене значення. Коли змінюєш адресу на інший хост, введи ключ знову. HolyArrs ніколи не надсилає збережений ключ на новий хост.

Варіанти

Для qBittorrent вони містяться під More options (додаткові параметри).

Категорія

HolyArrs складає свої завантаження в цю категорію й стежить лише за нею.

Застосунок	Як працює категорія
qBittorrent	Створюється за тебе, якщо її немає
SABnzbd	Має існувати заздалегідь, у Config > Categories
Transmission, Deluge	Зберігається як мітка
NZBGet	Надсилається як категорія завантаження

Пріоритет і теги

Priority (пріоритет) — від 1 до 50. Спершу береться найменше число, а однакові числа чергуються. З Tags (теги) цей завантажувач використовують лише тайтли зі спільним тегом. Тайтли без тегів використовують завантажувачі без тегів.

Шляхи

Заповнюй Downloader’s path (шлях завантажувача) і HolyArrs’ path (шлях HolyArrs) під Different folder names (різні назви тек) лише тоді, коли два застосунки бачать теку завантажень під різними назвами. Приклад: завантажувач зберігає в /data/torrents, а HolyArrs бачить її як /downloads. Add a path pair (додати пару шляхів) додає ще один рядок.

Краще рішення — одна спільна батьківська тека, змонтована за тим самим шляхом в обох контейнерах. Див. Теки.

Доступ до локальної мережі

Типово ввімкнено, бо завантажувачі зазвичай працюють удома. Вимкни для завантажувача в інтернеті.

HolyArrs може змінювати цей завантажувач

Якщо вимкнено, нові завантаження все одно йдуть туди, але HolyArrs ніколи не ставить на паузу, не змінює й не прибирає нічого, що там уже є. Користуйся цим для завантажувача, який ти ділиш з іншими застосунками.

Стеж за завантаженням

Сторінка тайтла показує кожне завантаження: чекає своєї черги, завантажується (зі швидкістю й часом, що лишився), зависло або завершилось помилкою з причиною.

Натисни Mark failed (позначити як невдале), щоб завершити завантаження, яке тобі не потрібне. Тоді HolyArrs:

1. Додає цей реліз до списку Turned down (відкинуті) для цього тайтла, щоб його не обрали знову.
2. Прибирає його із завантажувача разом з файлами.
3. Шукає знову й надсилає наступний найкращий реліз.

Якщо жоден інший реліз не проходить твої правила, тайтл показує Needs a decision (потрібне рішення).

Стани рядка

Стан	Що означає
Working	Відповів на останню перевірку
Paused (на паузі)	Ти поставив його на паузу. Нічого нового не надсилається; поточні завантаження й далі відстежуються
Resting (відпочиває)	Не відповів, тому HolyArrs чекає до вказаного часу
Not answering (не відповідає)	Остання перевірка не отримала відповіді
Sign-in refused (вхід відхилено)	Ключ або вхід відхилено

Pause і Resume (на паузу, відновити) у рядку зупиняють і відновлюють надсилання. Завантажувач, який перестав відповідати, пропускається до 30 хвилин.

Якщо не працює

Ознака: перевірка SABnzbd не проходить, коли в Address указано ім’я хоста. Причина: SABnzbd відхиляє імена хостів, яких не знає. Рішення: використай його IP-адресу або додай ім’я хоста HolyArrs до host_whitelist у SABnzbd, у Config > Special.

Ознака: SABnzbd каже, що категорії немає. Рішення: створи категорію в SABnzbd, у Config > Categories, а тоді натисни Test.

Ознака: Deluge не працює. Рішення: у Deluge Web UI сам підключись до свого daemon і ввімкни плагін Label. HolyArrs не обирає daemon.

Ознака: .torrent або .nzb із джерела з проксі відхиляється. Причина: Transmission, Deluge і NZBGet поки не можуть приймати ці файли через джерело з проксі. Magnet-посилання працюють.

Ознака: у рядку написано Check whether this download arrived (перевір, чи це завантаження дійшло). Причина: з’єднання обірвалося, поки Transmission, Deluge або NZBGet приймав реліз. HolyArrs не надсилає його знову сам. Рішення:

1. Знайди завантаження в застосунку завантажувача.
2. У HolyArrs натисни Give up on it (облишити його). Завантаження лишається у завантажувачі. Якщо хочеш, обери інший реліз у Needs a decision.

Ознака: Sign-in refused. Рішення: скопіюй ключ або пароль із завантажувача, введи його знову, натисни Test.

Більше в розділі Усунення проблем.

Для досвідчених

Як HolyArrs обирає завантажувач

• Торент-релізи йдуть торент-завантажувачам, Usenet-релізи — Usenet-завантажувачам.
• Спершу найменше число пріоритету. Однакові числа чергуються.
• Завантажувачі на паузі й ті, що відпочивають, пропускаються.
• Якщо один відхиляє реліз, пробується наступний того самого типу (Try the next Downloader (спробувати наступний завантажувач)).
• За замовчуванням між надсиланнями одному завантажувачу — 2 с.
• Теги мають збігатися. Тайтли без тегів ідуть до завантажувачів без тегів.

Коли завантаження йдуть не так: що враховується і які параметри

HolyArrs трактує це так само, як Mark failed:

• Завантажувач здається (бракує частин, невдале відновлення файлів). Його причина показується.
• Завантаження містить програми, як-от .exe, .bat, .scr чи .lnk, зокрема movie.mkv.exe.
• Завантаження схоже на фейк: нотатка з паролем, самі архіви без відео чи аудіо або вебярлик без медіа поруч. Списки файлів торента читаються одразу, як вони надходять, тож фейк провалюється ще до завантаження.
• Файли не збігаються з назвою релізу. Імпорт відхиляється, а завантаження прибирається.
• Немає прогресу протягом часу, після якого здаються. Очікування своєї черги, пауза у завантажувачі та відновлення файлів чи розпакування на 100% не рахуються.
• Завантаження прибрали поза HolyArrs. Його замінює наступний реліз.

Ці параметри містяться під When downloads go wrong (коли завантаження йдуть не так) на Settings > Downloaders. Натисни Save на панелі, що з’являється після зміни.

Параметр	Типово	Змінюй, коли
Remove failed downloads from the Downloader (прибирати невдалі завантаження із завантажувача)	увімкнено	Хочеш оглянути збої (вимкни). Якщо ввімкнено, їхні файли теж видаляються
Add matched titles to your Library (додавати зіставлені тайтли до бібліотеки)	вимкнено	Хочеш, щоб певний збіг, який уже є в завантажувачі, додавався без пошуку
When you remove a download: Delete its files (коли прибираєш завантаження: видалити його файли)	увімкнено	Хочеш зберегти файли
When you remove a download: Turn down its Release (коли прибираєш завантаження: відкинути його реліз)	вимкнено	Не хочеш, щоб цей реліз знову обирали для тайтла
When you remove a download: Search again (коли прибираєш завантаження: шукати знову)	увімкнено	Вимкни, якщо наступний реліз обираєш сам. Потрібен Turn down its Release
Stalled after (hours) (зависло після, годин)	6	Твої завантаження за своєю природою повільні. Діапазон від 1 до 168
Try the next Release after (hours) (спробувати наступний реліз після, годин)	24	Тобі краще почекати, ніж замінювати. Рахується від останнього прогресу. Діапазон: час зависання до 720
Fail downloads that hold programs or fakes (вважати невдалими завантаження з програмами чи фейками)	увімкнено	Рідко. Якщо вимкнено, вони доходять до імпорту
Replace downloads removed outside HolyArrs (замінювати завантаження, прибрані поза HolyArrs)	увімкнено	Ти прибираєш завантаження навмисно. Якщо вимкнено, тайтл чекає на тебе
Try the next Downloader	увімкнено	Хочеш лише один завантажувач
Seconds between sends to one Downloader (секунд між надсиланнями одному завантажувачу)	2	Завантажувач не справляється з пачками запитів. 0 вимикає інтервали. Діапазон від 0 до 60

Заблокуй завантажувач лише для читання з сервера

Постав у HOLYARRS_READONLY_DOWNLOADERS список id або адрес завантажувачів через кому:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Завантажувач зі списку лишається лише для читання, що б не казав його перемикач, навіть після видалення й повторного додавання. Перемикач показується заблокованим, а сторінка Downloads (завантаження) ховає елементи керування в його рядках.

Видалення, видалення в NZBGet, API

• Remove (прибрати) відхиляється, поки в завантажувача є активні завантаження. Постав його на паузу, дай їм завершитися, потім прибери.
• NZBGet видаляє файли щоразу, коли прибирають завантаження чи його запис в історії, тому HolyArrs відхиляє видалення із запитом залишити файли.
• Усі маршрути завантажувачів є в http://your-server:6262/api/v1/openapi.json.

Пов’язане

• Джерела
• Історія
• Теки