Clients de téléchargement

Connectez votre application de téléchargement pour que HolyArrs puisse lui envoyer des releases et importer ce qui est terminé.

HolyArrs ne télécharge rien lui-même. Il confie chaque release à un client de téléchargement, la suit et importe les fichiers.

Type	Applications
Torrent	qBittorrent, Transmission 4 ou plus récent, Deluge
Usenet	SABnzbd, NZBGet

Avant de commencer

• Vous êtes propriétaire ou administrateur.
• Votre application de téléchargement tourne et vous pouvez ouvrir sa page web.

Ajouter un client de téléchargement

1. Ouvrez Settings > Downloaders (Paramètres > Clients de téléchargement).

2. Appuyez sur Add a Downloader (ajouter un client de téléchargement).

3. Sous Which app (quelle application), choisissez votre application.

4. Saisissez un Name (nom).

5. Saisissez l’Address (adresse), la page web de l’application, par exemple http://192.168.1.10:8090.

6. Remplissez la connexion. Voir Connexion pour chaque application.

7. Appuyez sur Save (enregistrer), puis sur Test (tester) sur la ligne.

   Vous devriez voir Working (fonctionne) à côté du nom.

Attention

Si HolyArrs et le client de téléchargement tournent dans des conteneurs séparés et voient le dossier de téléchargement sous des chemins différents, les imports échouent. Remplissez la paire de chemins sous Chemins avant le premier téléchargement.

Connexion pour chaque application

Application	Quoi saisir	Où le trouver
qBittorrent	API key (clé API, qBittorrent 5.2 ou plus récent) ou Username and password (nom d’utilisateur et mot de passe)	Options > Web UI
Transmission	Nom d’utilisateur et mot de passe, vides s’il n’en demande pas	Paramètres de Transmission
Deluge	Mot de passe de la Web UI, sans nom d’utilisateur	Web UI de Deluge
SABnzbd	Clé API	Config > General
NZBGet	Nom d’utilisateur et mot de passe, vides si NZBGet laisse entrer HolyArrs sans eux	Paramètres de NZBGet

HolyArrs stocke les clés et les mots de passe chiffrés et ne les affiche plus jamais. Ne touchez pas au champ pour garder la valeur stockée. Quand vous changez l’adresse pour un autre hôte, saisissez la clé à nouveau. HolyArrs n’envoie jamais une clé stockée à un nouvel hôte.

Options

Pour qBittorrent, elles se trouvent sous More options (plus d’options).

Catégorie

HolyArrs range ses téléchargements dans cette catégorie et ne suit que cette catégorie.

Application	Comment fonctionne la catégorie
qBittorrent	Créée pour vous si elle manque
SABnzbd	Doit exister avant, sous Config > Categories
Transmission, Deluge	Stockée comme label
NZBGet	Envoyée comme catégorie du téléchargement

Priorité et étiquettes

Priority (priorité) va de 1 à 50. Le plus petit nombre est utilisé en premier, et les nombres égaux passent à tour de rôle. Avec Tags (étiquettes), seuls les titres qui partagent une étiquette utilisent ce client de téléchargement. Les titres sans étiquette utilisent les clients de téléchargement sans étiquette.

Chemins

Remplissez Downloader’s path (chemin du client de téléchargement) et HolyArrs’ path (chemin de HolyArrs) sous Different folder names (noms de dossier différents) seulement quand les deux applications voient le dossier de téléchargement sous des noms différents. Exemple : le client de téléchargement enregistre dans /data/torrents et HolyArrs le voit comme /downloads. Add a path pair (ajouter une paire de chemins) ajoute une autre ligne.

La meilleure solution reste un dossier parent partagé, monté au même chemin dans les deux conteneurs. Voir Dossiers.

Accès au réseau local

Activé par défaut, car les clients de téléchargement tournent en général à la maison. Désactivez-le pour un client de téléchargement situé sur Internet.

HolyArrs peut modifier ce client de téléchargement

Désactivé, les nouveaux téléchargements y vont toujours, mais HolyArrs ne met en pause, ne modifie et ne supprime jamais rien de ce qui s’y trouve déjà. À utiliser pour un client de téléchargement que vous partagez avec d’autres applications.

Suivre un téléchargement

La page d’un titre affiche chaque téléchargement : en attente de son tour, en cours avec la vitesse et le temps restant, bloqué, ou échoué avec la raison.

Appuyez sur Mark failed (marquer comme échoué) pour arrêter un téléchargement dont vous ne voulez pas. HolyArrs fait alors ceci :

1. Il ajoute cette release à la liste Turned down (écartées) du titre pour qu’elle ne soit plus choisie.
2. Il la supprime du client de téléchargement, avec ses fichiers.
3. Il relance une recherche et envoie la meilleure release suivante.

Si rien d’autre ne passe vos règles, le titre affiche Needs a decision (décision requise).

États des lignes

État	Signification
Working	A répondu au dernier contrôle
Paused (en pause)	Vous l’avez mis en pause. Rien de nouveau n’est envoyé ; les téléchargements en cours sont toujours suivis
Resting (au repos)	Il n’a pas répondu, donc HolyArrs attend jusqu’à l’heure indiquée
Not answering (ne répond pas)	Le dernier contrôle n’a reçu aucune réponse
Sign-in refused (connexion refusée)	La clé ou la connexion a été refusée

Pause (mettre en pause) et Resume (reprendre) sur la ligne arrêtent et relancent les envois. Un client de téléchargement qui ne répond plus est ignoré pendant 30 minutes au plus.

Si ça ne fonctionne pas

Symptôme : Le test de SABnzbd échoue quand Address contient un nom d’hôte. Cause : SABnzbd refuse les noms d’hôte qu’il ne connaît pas. Solution : Utilisez son adresse IP, ou ajoutez le nom d’hôte de HolyArrs à host_whitelist dans SABnzbd, sous Config > Special.

Symptôme : SABnzbd indique que la catégorie manque. Solution : Créez la catégorie dans SABnzbd sous Config > Categories, puis appuyez sur Test.

Symptôme : Deluge ne fonctionne pas. Solution : Dans la Web UI de Deluge, connectez-vous vous-même à votre daemon et activez le plugin Label. HolyArrs ne choisit pas de daemon.

Symptôme : Un .torrent ou un .nzb venant d’une source avec proxy est refusé. Cause : Transmission, Deluge et NZBGet ne peuvent pas encore recevoir ces fichiers par une source qui passe par un proxy. Les liens magnet fonctionnent.

Symptôme : Une ligne affiche Check whether this download arrived (vérifiez si ce téléchargement est arrivé). Cause : La connexion a été coupée pendant que Transmission, Deluge ou NZBGet recevait une release. HolyArrs ne la renvoie pas de lui-même. Solution :

1. Cherchez le téléchargement dans l’application de téléchargement.
2. Dans HolyArrs, appuyez sur Give up on it (abandonner). Le téléchargement reste dans le client de téléchargement. Choisissez une autre release sous Needs a decision si vous en voulez une.

Symptôme : Sign-in refused. Solution : Copiez la clé ou le mot de passe depuis le client de téléchargement, saisissez-le à nouveau, appuyez sur Test.

Plus d’informations dans Dépannage.

Pour les experts

Comment HolyArrs choisit un client de téléchargement

• Les releases torrent vont aux clients de téléchargement torrent, les releases Usenet aux clients Usenet.
• Le plus petit numéro de priorité d’abord. Les numéros égaux passent à tour de rôle.
• Les clients de téléchargement en pause ou au repos sont ignorés.
• Si l’un refuse une release, le suivant du même type est essayé (Try the next Downloader, essayer le client de téléchargement suivant).
• Les envois vers un même client de téléchargement sont espacés de 2 s par défaut.
• Les étiquettes doivent correspondre. Les titres sans étiquette vont aux clients de téléchargement sans étiquette.

Quand un téléchargement se passe mal : ce qui compte, et les paramètres

HolyArrs traite ces cas comme Mark failed :

• Le client de téléchargement abandonne (parties manquantes, réparation échouée). Sa raison est affichée.
• Le téléchargement contient des programmes comme .exe, .bat, .scr ou .lnk, y compris movie.mkv.exe.
• Le téléchargement a l’air d’un faux : une note de mot de passe, uniquement des archives sans vidéo ni audio, ou un raccourci web sans média à côté. Les listes de fichiers des torrents sont lues dès qu’elles arrivent, donc un faux échoue avant d’être téléchargé.
• Les fichiers ne correspondent pas au nom de la release. L’import est refusé et le téléchargement supprimé.
• Aucune progression pendant le délai d’abandon. L’attente de son tour, la pause dans le client de téléchargement, et la réparation ou la décompression à 100 % ne comptent pas.
• Le téléchargement a été supprimé en dehors de HolyArrs. Il est remplacé par la release suivante.

Ces paramètres se trouvent sous When downloads go wrong (quand un téléchargement se passe mal) dans Settings > Downloaders. Appuyez sur Save dans la barre qui apparaît après une modification.

Paramètre	Par défaut	À modifier quand
Remove failed downloads from the Downloader (supprimer les téléchargements échoués du client de téléchargement)	activé	Vous voulez examiner les échecs (désactivé). Activé, il supprime aussi leurs fichiers
Add matched titles to your Library (ajouter les titres reconnus à votre Bibliothèque)	désactivé	Vous voulez qu’un titre reconnu avec certitude, déjà dans un client de téléchargement, soit ajouté sans recherche
When you remove a download (quand vous supprimez un téléchargement) : Delete its files (supprimer ses fichiers)	activé	Vous voulez garder les fichiers
When you remove a download : Turn down its Release (écarter sa release)	désactivé	Vous ne voulez plus jamais que cette release soit choisie pour le titre
When you remove a download : Search again (relancer la recherche)	activé	Désactivé si vous choisissez vous-même la release suivante. Nécessite Turn down its Release
Stalled after (hours) (bloqué après, en heures)	6	Vos téléchargements sont lents par nature. Plage de 1 à 168
Try the next Release after (hours) (essayer la release suivante après, en heures)	24	Vous préférez attendre plutôt que remplacer. Compté à partir de la dernière progression. Plage : du délai de blocage jusqu’à 720
Fail downloads that hold programs or fakes (faire échouer les téléchargements qui contiennent des programmes ou des faux)	activé	Rarement. Désactivé, ils arrivent jusqu’à l’import
Replace downloads removed outside HolyArrs (remplacer les téléchargements supprimés en dehors de HolyArrs)	activé	Vous supprimez des téléchargements exprès. Désactivé, le titre vous attend
Try the next Downloader	activé	Vous ne voulez qu’un seul client de téléchargement
Seconds between sends to one Downloader (secondes entre deux envois vers un même client de téléchargement)	2	Le client de téléchargement sature quand tout arrive d’un coup. 0 désactive l’espacement. Plage de 0 à 60

Verrouiller un client de téléchargement en lecture seule depuis le serveur

Donnez à HOLYARRS_READONLY_DOWNLOADERS une liste, séparée par des virgules, d’identifiants ou d’adresses de clients de téléchargement :

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Un client de téléchargement listé reste en lecture seule quoi que dise son interrupteur, même après suppression et nouvel ajout. L’interrupteur s’affiche verrouillé, et la page Downloads masque les commandes sur ses lignes.

Suppression, suppressions dans NZBGet, API

• Remove (supprimer) est refusé tant que le client de téléchargement a des téléchargements actifs. Mettez-le en pause, laissez-les finir, puis supprimez-le.
• NZBGet supprime les fichiers dès qu’un téléchargement ou son entrée d’historique est supprimé, donc HolyArrs refuse les suppressions qui demandent de garder les fichiers.
• Toutes les routes des clients de téléchargement sont dans http://your-server:6262/api/v1/openapi.json.

Voir aussi

• Sources
• Historique
• Dossiers