Downloader

Einrichtung

Verbinde deine Download-App, damit HolyArrs ihr Releases übergeben und alles Fertige importieren kann.

HolyArrs lädt selbst nichts herunter. Es übergibt jedes Release an einen Downloader, verfolgt es und importiert die Dateien.

Art	Apps
Torrent	qBittorrent, Transmission 4 oder neuer, Deluge
Usenet	SABnzbd, NZBGet

Bevor du beginnst

Du bist Besitzer oder Admin.
Deine Download-App läuft, und du kannst ihre Weboberfläche öffnen.

Einen Downloader hinzufügen

Öffne Settings > Downloaders (Einstellungen > Downloader).
Klicke auf Add a Downloader (Downloader hinzufügen).
Wähle unter Which app (welche App) deine App.
Gib einen Name (Name) ein.
Gib die Address (Adresse) ein, also die Weboberfläche der App, etwa http://192.168.1.10:8090.
Trage die Anmeldung ein. Siehe Anmeldung für jede App.
Klicke auf Save (speichern) und dann in der Zeile auf Test (testen).

Du solltest Working (funktioniert) neben dem Namen sehen.

Anmeldung für jede App

App	Was du einträgst	Wo du es findest
qBittorrent	API key (API-Schlüssel, qBittorrent 5.2 oder neuer) oder Username and password (Benutzername und Passwort)	Options > Web UI
Transmission	Benutzername und Passwort, leer, wenn es keine verlangt	Einstellungen von Transmission
Deluge	Passwort der Web UI, kein Benutzername	Deluge Web UI
SABnzbd	API-Schlüssel	Config > General
NZBGet	Benutzername und Passwort, leer, wenn NZBGet HolyArrs auch ohne hereinlässt	Einstellungen von NZBGet

HolyArrs speichert Schlüssel und Passwörter verschlüsselt und zeigt sie nie wieder an. Lass das Feld unberührt, um den gespeicherten Wert zu behalten. Wenn du die Adresse auf einen anderen Host änderst, gib den Schlüssel erneut ein. HolyArrs schickt einen gespeicherten Schlüssel nie an einen neuen Host.

Optionen

Bei qBittorrent stehen diese unter More options (weitere Optionen).

Kategorie

HolyArrs legt seine Downloads in dieser Kategorie ab und verfolgt nur diese Kategorie.

App	Wie die Kategorie funktioniert
qBittorrent	Wird für dich angelegt, wenn sie fehlt
SABnzbd	Muss vorher vorhanden sein, unter Config > Categories
Transmission, Deluge	Wird als Label gespeichert
NZBGet	Wird als Download-Kategorie übergeben

Priorität und Tags

Priority (Priorität) reicht von 1 bis 50. Die niedrigste Zahl kommt zuerst dran, und gleiche Zahlen wechseln sich ab. Mit Tags nutzen nur Titel diesen Downloader, die einen Tag mit ihm teilen. Titel ohne Tag nutzen Downloader ohne Tag.

Pfade

Fülle Downloader’s path (Pfad des Downloaders) und HolyArrs’ path (Pfad von HolyArrs) unter Different folder names (unterschiedliche Ordnernamen) nur aus, wenn die beiden Apps den Download-Ordner unter verschiedenen Namen sehen. Beispiel: Der Downloader speichert nach /data/torrents, und HolyArrs sieht den Ordner als /downloads. Add a path pair (Pfadpaar hinzufügen) fügt eine weitere Zeile hinzu.

Die bessere Lösung ist ein gemeinsamer übergeordneter Ordner, der in beiden Containern unter demselben Pfad eingebunden ist. Siehe Ordner.

Lokales Netzwerk erreichen

Standardmäßig eingeschaltet, weil Downloader meist zu Hause laufen. Schalte es für einen Downloader im Internet aus.

HolyArrs darf diesen Downloader ändern

Aus heißt: Neue Downloads gehen weiterhin dorthin, aber HolyArrs pausiert, ändert oder entfernt nie etwas, das schon darin liegt. Nutze das für einen Downloader, den du mit anderen Apps teilst.

Einen Download verfolgen

Die Seite eines Titels zeigt jeden Download: in der Warteschlange, beim Herunterladen mit Geschwindigkeit und Restzeit, hängengeblieben oder fehlgeschlagen mit dem Grund.

Klicke auf Mark failed (als fehlgeschlagen markieren), um einen Download zu beenden, den du nicht willst. HolyArrs macht dann Folgendes:

Es setzt dieses Release auf die Liste Turned down (verworfen) des Titels, damit es nicht noch einmal gewählt wird.
Es entfernt es samt Dateien aus dem Downloader.
Es sucht erneut und übergibt das nächstbeste Release.

Wenn sonst nichts deine Regeln besteht, zeigt der Titel Needs a decision (Entscheidung nötig).

Zustände der Zeile

Zustand	Bedeutung
Working	Hat auf die letzte Prüfung geantwortet
Paused (pausiert)	Du hast ihn pausiert. Es wird nichts Neues übergeben, laufende Downloads werden weiter verfolgt
Resting (ruht)	Er hat nicht geantwortet, also wartet HolyArrs bis zur angezeigten Zeit
Not answering (antwortet nicht)	Die letzte Prüfung bekam keine Antwort
Sign-in refused (Anmeldung abgelehnt)	Der Schlüssel oder die Anmeldung wurde abgelehnt

Pause (pausieren) und Resume (fortsetzen) in der Zeile stoppen und starten die Übergabe. Ein Downloader, der nicht mehr antwortet, wird bis zu 30 Minuten übersprungen.

Wenn es nicht funktioniert

Symptom: Der Test für SABnzbd schlägt fehl, wenn in Address ein Hostname steht. Ursache: SABnzbd lehnt Hostnamen ab, die es nicht kennt. Lösung: Nutze seine IP-Adresse, oder trage den Hostnamen von HolyArrs in SABnzbd unter Config > Special bei host_whitelist ein.

Symptom: SABnzbd meldet, dass die Kategorie fehlt. Lösung: Lege die Kategorie in SABnzbd unter Config > Categories an und klicke dann auf Test.

Symptom: Deluge funktioniert nicht. Lösung: Verbinde dich in der Deluge Web UI selbst mit deinem Daemon und schalte das Plugin Label ein. HolyArrs wählt keinen Daemon aus.

Symptom: Eine .torrent- oder .nzb-Datei aus einer Quelle mit Proxy wird abgelehnt. Ursache: Transmission, Deluge und NZBGet können solche Dateien aus einer Quelle mit Proxy noch nicht annehmen. Magnet-Links funktionieren.

Symptom: In einer Zeile steht Check whether this download arrived (prüfe, ob dieser Download angekommen ist). Ursache: Die Verbindung ist abgebrochen, während Transmission, Deluge oder NZBGet ein Release angenommen hat. HolyArrs schickt es nicht von selbst noch einmal. Lösung:

Suche den Download in der Downloader-App.
Klicke in HolyArrs auf Give up on it (aufgeben). Der Download bleibt im Downloader. Wähle unter Needs a decision ein anderes Release, wenn du eins willst.

Symptom: Sign-in refused. Lösung: Kopiere den Schlüssel oder das Passwort aus dem Downloader, gib es erneut ein und klicke auf Test.

Mehr dazu in der Fehlerbehebung.

Für Fortgeschrittene

Wie HolyArrs einen Downloader wählt

Torrent-Releases gehen an Torrent-Downloader, Usenet-Releases an Usenet-Downloader.
Die niedrigste Prioritätszahl zuerst. Gleiche Zahlen wechseln sich ab.
Pausierte und ruhende Downloader werden übersprungen.
Lehnt einer ein Release ab, kommt der nächste derselben Art dran (Try the next Downloader, nächsten Downloader versuchen).
Zwischen zwei Übergaben an denselben Downloader liegen standardmäßig 2 s.
Tags müssen übereinstimmen. Titel ohne Tag gehen an Downloader ohne Tag.

Wenn Downloads schiefgehen: was zählt, und die Einstellungen

HolyArrs behandelt diese Fälle wie Mark failed:

Der Downloader gibt auf (fehlende Teile, fehlgeschlagene Reparatur). Sein Grund wird angezeigt.
Der Download enthält Programme wie .exe, .bat, .scr oder .lnk, auch movie.mkv.exe.
Der Download sieht nach einem Fake aus: ein Hinweis auf ein Passwort, nur Archive ohne Video oder Audio, oder eine Web-Verknüpfung ohne Medien daneben. Dateilisten von Torrents werden gelesen, sobald sie eintreffen. Ein Fake schlägt also fehl, bevor er heruntergeladen wird.
Die Dateien passen nicht zum Namen des Release. Der Import wird abgelehnt und der Download entfernt.
Kein Fortschritt über die Zeit bis zum Aufgeben. Warten in der Warteschlange, im Downloader pausiert sowie Reparieren oder Entpacken bei 100 % zählen nicht.
Der Download wurde außerhalb von HolyArrs entfernt. Er wird durch das nächste Release ersetzt.

Diese Einstellungen stehen unter When downloads go wrong (wenn Downloads schiefgehen) auf Settings > Downloaders. Klicke nach einer Änderung in der Leiste, die dann erscheint, auf Save.

Einstellung	Standard	Ändere sie, wenn
Remove failed downloads from the Downloader (fehlgeschlagene Downloads aus dem Downloader entfernen)	an	Du Fehlschläge untersuchen willst (aus). An löscht auch ihre Dateien
Add matched titles to your Library (zugeordnete Titel zu deiner Bibliothek hinzufügen)	aus	Ein sicherer Treffer, der schon in einem Downloader liegt, ohne Suche hinzugefügt werden soll
When you remove a download: Delete its files (wenn du einen Download entfernst: seine Dateien löschen)	an	Du die Dateien behalten willst
When you remove a download: Turn down its Release (wenn du einen Download entfernst: sein Release verwerfen)	aus	Dieses Release für den Titel nie wieder gewählt werden soll
When you remove a download: Search again (wenn du einen Download entfernst: erneut suchen)	an	Aus, wenn du das nächste Release selbst wählst. Braucht Turn down its Release
Stalled after (hours) (hängengeblieben nach, in Stunden)	6	Deine Downloads von Natur aus langsam sind. Bereich 1 bis 168
Try the next Release after (hours) (nächstes Release versuchen nach, in Stunden)	24	Du lieber wartest als ersetzt. Gezählt ab dem letzten Fortschritt. Bereich: von der Zeit für hängengeblieben bis 720
Fail downloads that hold programs or fakes (Downloads mit Programmen oder Fakes fehlschlagen lassen)	an	Selten. Aus lässt sie bis zum Import durch
Replace downloads removed outside HolyArrs (außerhalb von HolyArrs entfernte Downloads ersetzen)	an	Du Downloads absichtlich entfernst. Aus lässt den Titel auf dich warten
Try the next Downloader	an	Du nur einen Downloader willst
Seconds between sends to one Downloader (Sekunden zwischen Übergaben an einen Downloader)	2	Der Downloader sich an vielen Übergaben auf einmal verschluckt. 0 schaltet den Abstand aus. Bereich 0 bis 60

Einen Downloader vom Server aus schreibgeschützt sperren

Setze HOLYARRS_READONLY_DOWNLOADERS auf eine durch Kommas getrennte Liste von Downloader-IDs oder Adressen:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Ein aufgeführter Downloader bleibt schreibgeschützt, egal was sein Schalter sagt, auch nach Entfernen und erneutem Hinzufügen. Der Schalter wird als gesperrt angezeigt, und die Seite Downloads blendet die Bedienelemente in seinen Zeilen aus.

Entfernen, Entfernen bei NZBGet, API

Remove (entfernen) wird abgelehnt, solange der Downloader aktive Downloads hat. Pausiere ihn, lass sie fertig werden und entferne ihn dann.
NZBGet löscht Dateien immer, wenn ein Download oder sein Verlaufseintrag entfernt wird. Deshalb lehnt HolyArrs Entfernungen ab, bei denen die Dateien bleiben sollen.
Jede Downloader-Route steht in http://your-server:6262/api/v1/openapi.json.