Downloader

Hubungkan aplikasi unduhan kamu agar HolyArrs bisa mengirimkan rilis dan mengimpor yang sudah selesai.

HolyArrs tidak mengunduh sendiri. HolyArrs menyerahkan setiap rilis ke downloader, mengikutinya, lalu mengimpor file-nya.

Jenis	Aplikasi
Torrent	qBittorrent, Transmission 4 atau lebih baru, Deluge, rTorrent (dengan atau tanpa ruTorrent)
Usenet	SABnzbd, NZBGet

Sebelum mulai

• Kamu adalah pemilik atau admin.
• Aplikasi unduhan kamu sedang berjalan dan kamu bisa membuka halaman webnya.

Tambahkan downloader

1. Buka Settings > Downloaders (pengaturan > downloader).

2. Klik Add a Downloader (tambah downloader).

3. Di bawah Which app (aplikasi mana), pilih aplikasi kamu.

4. Ketik Name (nama).

5. Ketik Address (alamat), yaitu halaman web aplikasinya, misalnya http://192.168.1.10:8090. Untuk rTorrent, lihat Alamat rTorrent.

6. Isi data login. Lihat Login untuk tiap aplikasi.

7. Klik Save (simpan), lalu Test (uji) di barisnya.

   Kamu akan melihat Working (berfungsi) di samping namanya.

Perhatian

Kalau HolyArrs dan downloader berjalan di container terpisah dan melihat folder unduhan di path yang berbeda, impor gagal. Isi pasangan path di Path sebelum unduhan pertama.

Login untuk tiap aplikasi

Aplikasi	Yang diisi	Di mana menemukannya
qBittorrent	API key (qBittorrent 5.2 atau lebih baru) atau Username and password	Options > Web UI
Transmission	Nama pengguna dan kata sandi, kosongkan kalau tidak diminta	Pengaturan Transmission
Deluge	Kata sandi Web UI, tanpa nama pengguna	Deluge Web UI
rTorrent	Nama pengguna dan kata sandi web server di depan rTorrent, kosongkan kalau tidak diminta	Pengaturan web server atau seedbox kamu
SABnzbd	Kunci API	Config > General
NZBGet	Nama pengguna dan kata sandi, kosongkan kalau NZBGet mengizinkan HolyArrs masuk tanpa keduanya	Pengaturan NZBGet

HolyArrs menyimpan kunci dan kata sandi dalam bentuk terenkripsi dan tidak pernah menampilkannya lagi. Biarkan kolomnya apa adanya untuk mempertahankan yang tersimpan. Kalau kamu mengubah alamat ke host lain, ketik kuncinya lagi. HolyArrs tidak pernah mengirim kunci tersimpan ke host baru.

Alamat rTorrent

HolyArrs berbicara dengan rTorrent lewat XML-RPC. Address adalah tautan itu, bukan halaman ruTorrent.

Penyiapan	Alamat
crazymax/rtorrent-rutorrent	http://host:8000/RPC2. Port 8080 di sana adalah halaman ruTorrent
Lewat ruTorrent	http://host:8080/plugins/httprpc/action.php, atau /rutorrent/plugins/httprpc/action.php kalau ruTorrent berada di bawah /rutorrent. /plugins/rpc/rpc.php juga berfungsi
Seedbox	Tautan yang diberikan seedbox kamu, misalnya https://host/user/RPC2

Alamat tanpa path mendapat /RPC2. Diuji dengan rTorrent 0.16.25 dan ruTorrent 5.3.18.

HolyArrs mengambil sendiri setiap file .torrent dan mengirimkannya ke rTorrent, jadi rTorrent tidak pernah menghubungi sumber.

rTorrent di seedbox

Kalau rTorrent berjalan di komputer lain, HolyArrs tidak bisa melihat folder unduhannya. Siapkan sinkronisasi yang menyalin file yang selesai ke folder yang bisa dilihat HolyArrs. Lalu tambahkan pasangan path di Path: Downloader’s path adalah folder di seedbox, misalnya /home/user/downloads, dan HolyArrs’ path adalah folder lokal yang diisi oleh sinkronisasi itu.

Pilihan

Untuk qBittorrent, pilihan ini ada di bawah More options (opsi lainnya).

Kategori

HolyArrs menyimpan unduhannya di bawah kategori ini dan hanya mengikuti kategori itu.

Aplikasi	Cara kerja kategori
qBittorrent	Dibuatkan kalau belum ada
SABnzbd	Harus sudah ada, di Config > Categories
Transmission, Deluge	Disimpan sebagai label
rTorrent	Disimpan sebagai label di d.custom1, tampil di kolom Label ruTorrent
NZBGet	Dikirim sebagai kategori unduhan

Prioritas dan tag

Priority (prioritas) berkisar dari 1 sampai 50. Angka terendah dipakai lebih dulu, dan angka yang sama bergiliran. Dengan Tags, hanya judul yang punya tag yang sama yang memakai downloader ini. Judul tanpa tag memakai downloader tanpa tag.

Path

Isi Downloader’s path (path di downloader) dan HolyArrs’ path (path di HolyArrs) di bawah Different folder names (nama folder berbeda) hanya kalau kedua aplikasi melihat folder unduhan dengan nama yang berbeda. Contoh: downloader menyimpan ke /data/torrents dan HolyArrs melihatnya sebagai /downloads. Add a path pair (tambah pasangan path) menambah baris lagi.

Solusi yang lebih baik adalah satu folder induk bersama yang di-mount di path yang sama di kedua container. Lihat Folder.

Jangkau jaringan lokal

Aktif secara bawaan, karena downloader biasanya berjalan di rumah. Matikan untuk downloader yang ada di internet.

HolyArrs boleh mengubah downloader ini

Kalau nonaktif, unduhan baru tetap dikirim ke sana, tetapi HolyArrs tidak pernah menjeda, mengubah atau menghapus apa pun yang sudah ada di dalamnya. Pakai ini untuk downloader yang kamu bagi dengan aplikasi lain.

Ikuti sebuah unduhan

Halaman sebuah judul menampilkan setiap unduhan: menunggu giliran, mengunduh dengan kecepatan dan sisa waktu, macet, atau gagal beserta alasannya.

Klik Mark failed (tandai gagal) untuk mengakhiri unduhan yang tidak kamu inginkan. Lalu HolyArrs:

1. Menambahkan rilis itu ke daftar Turned down (dibuang) milik judul tersebut agar tidak dipilih lagi.
2. Menghapusnya dari downloader, beserta file-nya.
3. Mencari lagi dan mengirim rilis terbaik berikutnya.

rTorrent tidak bisa menghapus file lewat XML-RPC, jadi HolyArrs menghapusnya sendiri di tempat folder simpan atau pasangan path-nya terjangkau. Kalau tidak, file tetap ada di komputer rTorrent.

Kalau tidak ada rilis lain yang lolos aturan kamu, judul itu menampilkan Needs a decision (perlu keputusan).

Status baris

Status	Artinya
Working	Menjawab pada pemeriksaan terakhir
Paused (dijeda)	Kamu menjedanya. Tidak ada yang baru dikirim; unduhan yang sedang berjalan tetap diikuti
Resting (beristirahat)	Tidak menjawab, jadi HolyArrs menunggu sampai waktu yang ditampilkan
Not answering (tidak merespons)	Pemeriksaan terakhir tidak mendapat jawaban
Sign-in refused (login ditolak)	Kunci atau login ditolak

Pause (jeda) dan Resume (lanjutkan) di baris menghentikan dan memulai pengiriman. Downloader yang berhenti menjawab dilewati sampai 30 menit.

Kalau tidak berhasil

Gejala: Uji SABnzbd gagal ketika Address memakai nama host. Penyebab: SABnzbd menolak nama host yang tidak dikenalnya. Solusi: Pakai alamat IP-nya, atau tambahkan nama host HolyArrs ke host_whitelist di SABnzbd, di Config > Special.

Gejala: SABnzbd bilang kategorinya tidak ada. Solusi: Buat kategorinya di SABnzbd, di Config > Categories, lalu klik Test.

Gejala: Deluge tidak berfungsi. Solusi: Di Deluge Web UI, hubungkan sendiri ke daemon kamu dan aktifkan plugin Label. HolyArrs tidak memilihkan daemon.

Gejala: Uji rTorrent bilang 404 atau tidak ditemukan. Penyebab: Port atau path salah. Dengan crazymax/rtorrent-rutorrent, 8000 adalah XML-RPC dan 8080 adalah halaman ruTorrent. Solusi: Pakai http://host:8000/RPC2, atau path ruTorrent dari Alamat rTorrent.

Gejala: rTorrent bilang not allowed for untrusted connections. Penyebab: ruTorrent memblokir perintah yang dibutuhkan HolyArrs. Solusi: Update ruTorrent, atau arahkan Address ke /RPC2 milik rTorrent.

Gejala: rTorrent menolak sebuah rilis dengan kesalahan batas ukuran. Solusi: Naikkan network.xmlrpc.size_limit di konfigurasi rTorrent. Di crazymax/rtorrent-rutorrent, atur XMLRPC_SIZE_LIMIT.

Gejala: Sebuah .torrent atau .nzb dari sumber dengan proxy ditolak. Penyebab: Transmission, Deluge, rTorrent dan NZBGet belum bisa menerima file itu lewat sumber yang memakai proxy. Tautan magnet berfungsi.

Gejala: Sebuah baris menampilkan Check whether this download arrived (periksa apakah unduhan ini sudah sampai). Penyebab: Koneksi terputus saat Transmission, Deluge, rTorrent atau NZBGet sedang menerima sebuah rilis. HolyArrs tidak mengirimnya lagi sendiri. Solusi:

1. Cari unduhannya di aplikasi downloader.
2. Di HolyArrs, klik Give up on it (lepaskan saja). Unduhannya tetap ada di downloader. Pilih rilis lain di bawah Needs a decision kalau kamu mau.

Gejala: Sign-in refused. Solusi: Salin kunci atau kata sandi dari downloader, ketik lagi, klik Test.

Selengkapnya di Pemecahan masalah.

Untuk yang mahir

Cara HolyArrs memilih downloader

• Rilis torrent dikirim ke downloader torrent, rilis Usenet ke downloader Usenet.
• Angka prioritas terendah lebih dulu. Angka yang sama bergiliran.
• Downloader yang dijeda dan yang beristirahat dilewati.
• Kalau satu downloader menolak sebuah rilis, yang berikutnya dari jenis yang sama dicoba (Try the next Downloader).
• Pengiriman ke satu downloader diberi jeda 2 detik secara bawaan.
• Tag harus cocok. Judul tanpa tag dikirim ke downloader tanpa tag.

Saat unduhan bermasalah: apa yang dihitung, dan pengaturannya

HolyArrs memperlakukan hal-hal ini seperti Mark failed:

• Downloader menyerah (bagian hilang, perbaikan gagal). Alasannya ditampilkan.
• Unduhan berisi program seperti .exe, .bat, .scr atau .lnk, termasuk movie.mkv.exe.
• Unduhan terlihat palsu: catatan kata sandi, hanya arsip tanpa video atau audio, atau pintasan web tanpa media di sampingnya. Daftar file torrent dibaca begitu tiba, jadi yang palsu gagal sebelum diunduh.
• File tidak cocok dengan nama rilis. Impor ditolak dan unduhan dihapus.
• Tidak ada kemajuan selama waktu menyerah. Menunggu giliran, dijeda di downloader, dan memperbaiki atau mengekstrak di 100% tidak dihitung.
• Unduhan dihapus di luar HolyArrs. Unduhan itu diganti dengan rilis berikutnya.

Pengaturan ini ada di bawah When downloads go wrong (saat unduhan bermasalah) di Settings > Downloaders. Klik Save di bar yang muncul setelah ada perubahan.

Pengaturan	Bawaan	Ubah kalau
Remove failed downloads from the Downloader	aktif	Kamu ingin memeriksa unduhan yang gagal (nonaktif). Kalau aktif, file-nya juga dihapus
Add matched titles to your Library	nonaktif	Kamu ingin kecocokan yang pasti dari unduhan yang sudah ada di downloader ditambahkan tanpa pencarian
When you remove a download: Delete its files	aktif	Kamu ingin file-nya disimpan
When you remove a download: Turn down its Release	nonaktif	Kamu tidak mau rilis itu dipilih lagi untuk judulnya
When you remove a download: Search again	aktif	Nonaktifkan kalau kamu memilih rilis berikutnya sendiri. Butuh Turn down its Release
Stalled after (hours)	6	Unduhan kamu memang lambat. Rentang 1 sampai 168
Try the next Release after (hours)	24	Kamu lebih suka menunggu daripada mengganti. Dihitung dari kemajuan terakhir. Rentang: waktu macet sampai 720
Fail downloads that hold programs or fakes	aktif	Jarang. Kalau nonaktif, program dan yang palsu bisa sampai ke impor
Replace downloads removed outside HolyArrs	aktif	Kamu sengaja menghapus unduhan. Kalau nonaktif, judulnya menunggu kamu
Try the next Downloader	aktif	Kamu hanya ingin satu downloader
Seconds between sends to one Downloader	2	Downloader tersendat oleh kiriman beruntun. 0 mematikan jeda. Rentang 0 sampai 60

Kunci downloader jadi hanya-baca dari server

Setel HOLYARRS_READONLY_DOWNLOADERS ke daftar id atau alamat downloader yang dipisah koma:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Downloader yang terdaftar tetap hanya-baca apa pun yang dikatakan sakelarnya, bahkan setelah dihapus dan ditambahkan lagi. Sakelarnya tampil terkunci, dan halaman Unduhan menyembunyikan kontrol di barisnya.

Menghapus, penghapusan NZBGet, API

• Remove (hapus) ditolak selama downloader masih punya unduhan aktif. Jeda dulu, biarkan selesai, lalu hapus.
• NZBGet menghapus file setiap kali sebuah unduhan atau entri riwayatnya dihapus, jadi HolyArrs menolak penghapusan yang meminta file dipertahankan.
• rTorrent tidak bisa menghapus data lewat XML-RPC. Saat sebuah penghapusan meminta file dihapus, HolyArrs menghapusnya sendiri di tempat folder simpan atau pasangan path-nya terjangkau. Kalau tidak, file tetap ada di komputer rTorrent dan HolyArrs mencatat alasannya di log.
• Di Downloads (unduhan), baris rTorrent menawarkan Pause dan Resume, tetapi tidak kontrol qBittorrent lainnya.
• Setiap route downloader ada di http://your-server:6262/api/v1/openapi.json.

Terkait

• Sumber
• Riwayat
• Folder