Downloader

Collega la tua app di download così HolyArrs può inviarle le release e importare ciò che finisce.

HolyArrs non scarica da solo. Passa ogni release a un downloader, lo segue e importa i file.

Tipo	App
Torrent	qBittorrent, Transmission 4 o successivo, Deluge
Usenet	SABnzbd, NZBGet

Prima di iniziare

• Sei il proprietario o un amministratore.
• La tua app di download è in esecuzione e puoi aprire la sua pagina web.

Aggiungere un downloader

1. Apri Settings > Downloaders (impostazioni > downloader).

2. Premi Add a Downloader (aggiungi un downloader).

3. Sotto Which app (quale app), scegli la tua app.

4. Scrivi un Name (nome).

5. Scrivi l’Address (indirizzo), la pagina web dell’app, come http://192.168.1.10:8090.

6. Compila l’accesso. Vedi Accesso per ogni app.

7. Premi Save (salva), poi Test (prova) sulla riga.

   Dovresti vedere Working (funziona) accanto al nome.

Attenzione

Se HolyArrs e il downloader girano in container separati e vedono la cartella dei download con percorsi diversi, le importazioni falliscono. Compila la coppia di percorsi in Percorsi prima del primo download.

Accesso per ogni app

App	Cosa inserire	Dove trovarlo
qBittorrent	API key (chiave API) (qBittorrent 5.2 o successivo) oppure Username and password (nome utente e password)	Options > Web UI
Transmission	Nome utente e password, vuoti se non li chiede	Impostazioni di Transmission
Deluge	Password della Web UI, senza nome utente	Web UI di Deluge
SABnzbd	Chiave API	Config > General
NZBGet	Nome utente e password, vuoti se NZBGet fa entrare HolyArrs senza	Impostazioni di NZBGet

HolyArrs salva chiavi e password cifrate e non le mostra più. Lascia il campo com’è per tenere quella salvata. Quando cambi l’indirizzo con un altro host, scrivi di nuovo la chiave. HolyArrs non invia mai una chiave salvata a un nuovo host.

Scelte

Per qBittorrent si trovano sotto More options (altre opzioni).

Categoria

HolyArrs archivia i suoi download in questa categoria e segue solo quella categoria.

App	Come funziona la categoria
qBittorrent	Creata per te se manca
SABnzbd	Deve esistere prima, in Config > Categories
Transmission, Deluge	Salvata come etichetta
NZBGet	Inviata come categoria del download

Priorità e tag

La Priority (priorità) va da 1 a 50. Il numero più basso viene usato per primo, e numeri uguali si alternano. Con i Tags, solo i titoli che hanno un tag in comune usano questo downloader. I titoli senza tag usano i downloader senza tag.

Percorsi

Compila Downloader’s path (percorso del downloader) e HolyArrs’ path (percorso di HolyArrs) sotto Different folder names (nomi di cartella diversi) solo quando le due app vedono la cartella dei download con nomi diversi. Esempio: il downloader salva in /data/torrents e HolyArrs la vede come /downloads. Add a path pair (aggiungi una coppia di percorsi) aggiunge un’altra riga.

La soluzione migliore è una cartella madre condivisa, montata allo stesso percorso in entrambi i container. Vedi Cartelle.

Raggiungere la rete locale

Attivo per impostazione predefinita, perché i downloader di solito girano in casa. Disattivalo per un downloader su internet.

HolyArrs può modificare questo downloader

Disattivato significa che i nuovi download ci vanno comunque, ma HolyArrs non mette mai in pausa, non cambia e non rimuove nulla di ciò che c’è già dentro. Usalo per un downloader che condividi con altre app.

Seguire un download

La pagina di un titolo mostra ogni download: in coda, in download con velocità e tempo rimasto, bloccato, o fallito con il motivo.

Premi Mark failed (segna come fallito) per chiudere un download che non vuoi. HolyArrs poi:

1. Aggiunge quella release all’elenco Turned down (scartate) del titolo, così non viene scelta di nuovo.
2. La rimuove dal downloader, insieme ai suoi file.
3. Cerca di nuovo e invia la prossima migliore release.

Se nessun’altra release rispetta le tue regole, il titolo mostra Needs a decision (richiede una decisione).

Stati della riga

Stato	Significato
Working (funziona)	Ha risposto all’ultimo controllo
Paused (in pausa)	L’hai messo in pausa tu. Non viene inviato nulla di nuovo; i download in corso vengono ancora seguiti
Resting (a riposo)	Non ha risposto, quindi HolyArrs aspetta fino all’ora indicata
Not answering (non risponde)	L’ultimo controllo non ha avuto risposta
Sign-in refused (accesso rifiutato)	La chiave o l’accesso sono stati rifiutati

Pause (pausa) e Resume (riprendi) sulla riga fermano e fanno ripartire gli invii. Un downloader che smette di rispondere viene saltato fino a 30 minuti.

Se non funziona

Sintomo: La prova di SABnzbd fallisce quando Address usa un nome host. Causa: SABnzbd rifiuta i nomi host che non conosce. Soluzione: Usa il suo indirizzo IP, oppure aggiungi il nome host di HolyArrs a host_whitelist in SABnzbd sotto Config > Special.

Sintomo: SABnzbd dice che la categoria manca. Soluzione: Crea la categoria in SABnzbd sotto Config > Categories, poi premi Test.

Sintomo: Deluge non funziona. Soluzione: Nella Web UI di Deluge, connettiti tu al tuo daemon e attiva il plugin Label. HolyArrs non sceglie un daemon.

Sintomo: Un .torrent o .nzb da una Fonte con un proxy viene rifiutato. Causa: Transmission, Deluge e NZBGet non possono ancora ricevere quei file tramite una Fonte con proxy. I link magnet funzionano.

Sintomo: Una riga dice Check whether this download arrived (controlla se questo download è arrivato). Causa: La connessione è caduta mentre Transmission, Deluge o NZBGet stava ricevendo una release. HolyArrs non la invia di nuovo da solo. Soluzione:

1. Cerca il download nell’app del downloader.
2. In HolyArrs, premi Give up on it (rinuncia). Il download resta nel downloader. Scegli un’altra release in Needs a decision se ne vuoi una.

Sintomo: Sign-in refused. Soluzione: Copia la chiave o la password dal downloader, scrivila di nuovo, premi Test.

Altro in Risoluzione dei problemi.

Per esperti

Come HolyArrs sceglie un downloader

• Le release torrent vanno ai downloader torrent, quelle Usenet ai downloader Usenet.
• Prima il numero di priorità più basso. Numeri uguali si alternano.
• I downloader in pausa e a riposo vengono saltati.
• Se uno rifiuta una release, si prova il successivo dello stesso tipo (Try the next Downloader).
• Gli invii verso un downloader sono distanziati di 2 s per impostazione predefinita.
• I tag devono corrispondere. I titoli senza tag vanno ai downloader senza tag.

Quando i download vanno male: cosa conta, e le impostazioni

HolyArrs tratta questi casi come Mark failed:

• Il downloader rinuncia (parti mancanti, riparazione fallita). Il suo motivo viene mostrato.
• Il download contiene programmi come .exe, .bat, .scr o .lnk, compreso movie.mkv.exe.
• Il download sembra falso: una nota con una password, solo archivi senza video né audio, o un collegamento web senza media accanto. Gli elenchi di file dei torrent vengono letti appena arrivano, così un falso fallisce prima di scaricare.
• I file non corrispondono al nome della release. L’importazione viene rifiutata e il download rimosso.
• Nessun avanzamento per il tempo di rinuncia. Non contano l’attesa in coda, la pausa nel downloader, né la riparazione o l’estrazione al 100%.
• Il download è stato rimosso fuori da HolyArrs. Viene sostituito con la release successiva.

Queste impostazioni stanno sotto When downloads go wrong (quando i download vanno male) in Settings > Downloaders. Premi Save nella barra che appare dopo una modifica.

Impostazione	Predefinito	Cambiala quando
Remove failed downloads from the Downloader	attivo	Vuoi ispezionare i fallimenti (disattivo). Attivo cancella anche i loro file
Add matched titles to your Library	disattivo	Vuoi che un titolo già presente in un downloader, con una corrispondenza sicura, venga aggiunto senza cercare
When you remove a download: Delete its files	attivo	Vuoi tenere i file
When you remove a download: Turn down its Release	disattivo	Non vuoi mai più che quella release venga scelta per il titolo
When you remove a download: Search again	attivo	Disattivo se scegli tu la release successiva. Richiede Turn down its Release
Stalled after (hours)	6	I tuoi download sono lenti per natura. Intervallo da 1 a 168
Try the next Release after (hours)	24	Preferisci aspettare invece di sostituire. Contato dall’ultimo avanzamento. Intervallo: dal tempo di blocco fino a 720
Fail downloads that hold programs or fakes	attivo	Di rado. Disattivo li lascia arrivare all’importazione
Replace downloads removed outside HolyArrs	attivo	Rimuovi i download di proposito. Disattivo: il titolo aspetta una tua decisione
Try the next Downloader	attivo	Vuoi un solo downloader
Seconds between sends to one Downloader	2	Il downloader non regge gli invii a raffica. 0 disattiva la distanza. Intervallo da 0 a 60

Bloccare un downloader in sola lettura dal server

Imposta HOLYARRS_READONLY_DOWNLOADERS con un elenco separato da virgole di id o indirizzi dei downloader:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Un downloader nell’elenco resta in sola lettura qualunque sia il suo interruttore, anche dopo averlo rimosso e aggiunto di nuovo. L’interruttore appare bloccato, e la pagina Download nasconde i controlli sulle sue righe.

Rimozione, rimozioni con NZBGet, API

• Remove (rimuovi) viene rifiutato finché il downloader ha download attivi. Mettilo in pausa, lascia che finiscano, poi rimuovilo.
• NZBGet cancella i file ogni volta che un download o la sua voce di cronologia viene rimossa, quindi HolyArrs rifiuta le rimozioni che chiedono di tenere i file.
• Ogni route dei downloader è in http://your-server:6262/api/v1/openapi.json.

Correlati

• Fonti
• Cronologia
• Cartelle