⚡ nzbfast

Der schnelle Usenet-Downloader - Benutzerhandbuch

1 · Willkommen

nzbfast lädt aus dem Usenet so schnell, wie es deine Leitung, deine Provider und deine Maschine zulassen - und das heißt meistens: so schnell wie deine Leitung. Es ist ein einziges, in sich geschlossenes Programm: die Engine, ein Web-Dashboard, eine Posterwand als Medienbrowser, ein eingebauter Indexer, Echtzeit-Vorschau, native PAR2-Reparatur und natives RAR-Entpacken stecken alle in einer einzigen ausführbaren Datei. Es gibt nichts weiter zu installieren.

Schnell macht es die Architektur, nicht irgendwelche Tricks:

• Pipelined NNTP - viele Artikel-Anfragen reisen Rücken an Rücken über jede Verbindung und halten sie auf voller Geschwindigkeit, statt Round-Trips auszusitzen.
• Eine One-Pass-Pipeline - Download, Prüfung und Entpacken überlappen sich. Archiv-Volumes werden im Datenstrom entpackt; bei einem typischen Store-Mode-Post berühren die RAR-Dateien deine Festplatte nie - der Job braucht 1× die Release-Größe statt 2× und ist fertig, sobald der Download fertig ist.
• Multi-Provider-Verbund - jeder konfigurierte Server trägt bei; ein Artikel, der auf einem Backbone fehlt, wird von einem anderen geholt. Langsame oder tote Server bremsen die Warteschlange nie aus.
• Ein Speicher-Budget - die Engine hält sich an eine begrenzte RAM-Zuteilung und weicht bei Bedarf auf die Festplatte aus. Sie bringt deine Maschine nie zum Swappen.

Auf identischer Hardware, mit identischen Jobs und Providern gegen das Feld gemessen, hat nzbfast einen 190 GB-Download auf einer 10 GbE-Leitung in rund 5 Minuten abgeschlossen - die führenden Alternativen lagen in denselben Tests 30–220 % zurück, sofern sie sie überhaupt beendet haben. Die Zahlen stehen in §3.

2 · Schnellstart

macOS

1. Öffne nzbfast-<version>-macos.dmg und zieh NzbFast nach Programme (universal: Apple Silicon + Intel).
2. Erster Start: macOS warnt, dass nzbfast noch nicht von Apple notarisiert ist. Rechtsklick auf die App → Öffnen - oder öffne die Systemeinstellungen → Datenschutz & Sicherheit, scroll nach unten und klick Dennoch öffnen. Das ist nur einmal nötig.
3. Das App-Fenster zeigt das Dashboard mit einer Willkommens-Karte - klick sie an und füge mindestens einen Usenet-Server hinzu (Host, Port 563, Benutzername, Passwort). Weitere kannst du später in den Einstellungen ergänzen.
4. Zieh eine .nzb irgendwo aufs Dashboard - oder doppelklick .nzb-Dateien einfach im Finder. Downloads landen in ~/Downloads/nzbfast. Beenden über das Menü; Downloads setzen dort fort, wo sie aufgehört haben.

Lieber ohne App? Das schlichte Zip (Binary + Start nzbfast.command-Starter, gleiche Engine) funktioniert weiter wie gehabt - die Schritte stehen unten unter „Aus dem Terminal“.

Windows

1. Führe nzbfast-setup-<version>.exe aus. Es installiert nur für deinen Benutzer (kein Administrator-Passwort). Weil dieses Release noch nicht code-signiert ist, zeigt SmartScreen womöglich „Der Computer wurde durch Windows geschützt“ - klick Weitere Informationen → Trotzdem ausführen.
2. nzbfast lebt im System-Tray: Doppelklick aufs Tray-Symbol (oder Dashboard öffnen im Rechtsklick-Menü) öffnet das Dashboard; füge dann deinen Usenet-Server über die Willkommens-Karte hinzu. Das Tray-Menü bietet außerdem Pause/Fortsetzen, deinen Download-Ordner und Beenden.
3. Ein Doppelklick auf eine .nzb-Datei reiht sie ein. Windows Defender fragt eventuell einmal, ob lokales Netzwerk-Lauschen erlaubt werden soll - erlaub es.

Lieber eine portable Kopie? Das -windows-x64.zip funktioniert weiterhin: irgendwo entpacken und nzbfast.exe doppelklicken (oder Start nzbfast.bat für den Terminal-Assistenten).

Aus dem Terminal (jede Plattform)

nzbfast setup            # interactive server setup (writes config.local.json)
nzbfast serve --open     # start the daemon and open the dashboard

3 · So funktioniert nzbfast

Ein kurzes Vokabular, damit sich der Rest des Handbuchs leicht liest:

Die Pipeline fährt Download → Dekodieren → Prüfen → Entpacken gleichzeitig. Die Pipeline-Karte im Dashboard zeigt alle drei Spuren gleichzeitig in Bewegung. Wenn das letzte Byte ankommt, ist die Prüfung schon durch und die Datei schon entpackt; die „Nachbearbeitungszeit“ eines typischen Jobs ist null. Nur wenn repariert werden muss, werden Volumes auf die Festplatte materialisiert, von der nativen GF(2¹⁶)-Engine an Ort und Stelle repariert (umbenannte oder byte-verschobene, verschleierte Daten findet und übernimmt ein gleitender Block-Scan) und neu entpackt - alles automatisch.

Unterbrochene Downloads (Absturz, Stromausfall, kill -9) setzen über das Artikel-Journal fort: Bytes, die schon auf der Festplatte liegen, werden nie doppelt geholt. Das Journal hält fest, wo die Bytes jedes Artikels physisch gelandet sind - auch Bytes, die direkt in die endgültige Datei entpackt wurden -, sodass ein Resume aus der lokalen Festplatte wiederaufbaut und alles Wiederhergestellte gegen die PAR2-Blockkarte nachprüft, bevor es ihm vertraut.

Der Vergleich

Gemessen gegen SABnzbd 5.0.4 und NZBGet 26.2 auf derselben Maschine, mit denselben Providern und denselben NZBs, gestoppt bis zur nutzbaren Datei - Download, Prüfung, Reparatur und Entpacken eingeschlossen, denn erst dann ist der Job wirklich fertig:

Der Abstand ist die Nachbearbeitung, die die anderen nach dem letzten Byte noch vor sich haben. Beide Konkurrenten wurden für den Vergleich getunt, nicht auf Standardwerten gelassen - SABnzbd liefert Request-Pipelining ab Werk abgeschaltet aus, was es teuer zu stehen kommt, also wurde es eingeschaltet.

Zwei Unterschiede wiegen so schwer wie die Zeiten:

• Festplattenplatz. Ein Durchgang braucht 1× die Release-Größe; Clients, die Archiv-Volumes schreiben und dann entpacken, brauchen 2×. Auf einer Testmaschine mit 97 GB frei war ein 87-GB-Job hier in 3 m 08 s fertig - die anderen beiden konnten gar nicht erst laufen.
• Speicher. Beim 190-GB-Job lag der Spitzenverbrauch bei 3,9 GB gegen SABnzbds 9,3 GB - und auf Wunsch erledigt nzbfast denselben Job in etwa 1 GB (siehe Speicher-Budget).

4 · Das Dashboard

Öffne http://localhost:6789 (oder die Adresse deiner Maschine von einem anderen Gerät - das Handy-Layout passt sich automatisch an). Alles aktualisiert sich live, einmal pro Sekunde. Die Karten, von oben nach unten:

Kopfleiste

• Tempolimit-Menü - feste Limits, auto · LAN hat Vorrang (ein RTT-gesteuerter Modus, der zurückweicht, wenn jemand anderes im Haus die Leitung braucht) oder unbegrenzt.
• Pausieren für… - alles für 15 Min/30 Min/1 Std/3 Std pausieren, mit automatischem Fortsetzen, oder der Pause-Knopf für eine offene Pause. Pause greift sofort: Der aktive Transfer stoppt binnen Sekunden und setzt später aus dem Journal fort, ohne etwas zu verlieren. (Jobs mit Priorität „Erzwingen“ laden weiter, wie bei SABnzbd.)
• Ein Update-Banner erscheint hier, wenn eine neue Version verfügbar ist (siehe Updates).

Durchsatz

Live-MB/s mit laufendem Diagramm; die gestrichelten Wasserzeichen markieren Hoch/Tief dieser Sitzung, die blasse Linie ist ein gleitender Durchschnitt. Darunter zeigt ein Histogramm, wie sich die Tempo-Messwerte der Sitzung verteilen - typisch vs. Spitze. Mach das Fenster breiter und die Diagramme zeigen mehr Verlauf (bis zu einer Stunde).

Statistik-Kacheln

In dieser Sitzung geladen, Warteschlangen-Tiefe, Fertig-/Fehler-Zähler, Spitzentempo der Sitzung.

Ressourcen - eine Maschine, vier Limits

CPU, RAM (gegen nzbfasts Speicher-Budget), Festplatten-Schreibrate und Netzwerk auf einem normalisierten Diagramm, mit echten Werten in der Legende und einer Warnung bei wenig Plattenplatz. Kein anderer NZB-Client zeigt dir das; es existiert, um einen Punkt zu beweisen - nzbfast reizt deine Leitung aus, nicht deine Maschine.

Pipeline - Stufen überlappen

Drei Spuren: Download, Prüfen (geprüfte PAR2-Blöcke), Entpacken. Bei einem gesunden Job bewegen sich alle drei gemeinsam.

Provider

Live-Rate pro Server, Verbindungsauslastung, Verkehrsanteil, Sitzungs-GB und ein Lebenszeit-Wert für Artikel-Vollständigkeit (farbig, sobald ein Server unter 98 % fällt). Ein gestapeltes Flächendiagramm zeigt den Beitrag jedes Providers über die Zeit. Die Zeilen sortieren sich alle 10 s nach Live-Leistung neu (einstellbar in Einstellungen → Oberfläche), damit dein schnellster Provider immer oben steht.

Warteschlange

• Zeilen ziehen zum Umsortieren (innerhalb eines Prioritätsbands - Erzwingen/Hoch läuft trotzdem zuerst); Priorität direkt in der Zeile ändern.
• Klick auf eine Zeile für die Detail-Schublade: Fortschrittsbalken pro Datei, Prüf-Blockzähler und welcher Server wie viel zu diesem Job beigetragen hat.
• Badges zeigen Sonderzustände: zurückgestellt (langsam), Prefetch, pausiert (siehe Performance-Tools).
• Ein Burn-down-Diagramm verfolgt die verbleibenden GB über die ganze Warteschlange.

Index durchsuchen

Durchsuche alles, was der eingebaute Indexer aus deinen beobachteten Gruppen katalogisiert hat (siehe Automatisierung), und lade mit einem Klick - kein externer Indexer nötig. Die Statuszeile zeigt den Scan-Fortschritt; Jetzt scannen erzwingt einen Durchlauf.

Watchlist

Füge Titel per Name hinzu - auch solche, die noch gar nicht gepostet wurden. Taucht ein passendes Release im Index auf, wird es automatisch geholt, mit Qualitätsvorlieben und Upgrade-Regeln (eine bessere Kopie ersetzt eine schlechtere).

Verlauf

Die jüngsten Downloads mit Status, Größe, Ort; fehlgeschlagene Jobs bieten Erneut (setzt aus dem Journal fort). Verschlüsselte Archive zeigen ein 🔑-Entsperr-Element - gib das Passwort ein und der Job wird an Ort und Stelle fertig. Der Prüfstatus-Streifen zeichnet defekte PAR2-Blöcke pro Download auf - ein steigendes Ende heißt: Artikel kommen beschädigt an.

Datenverbrauch

Tagesbalken pro Provider und Summen für Heute / 7 Tage / 30 Tage - unverzichtbar bei Volumen- und Block-Tarifen. Block-Konten zeigen die Lebenszeitnutzung gegen ihre Größe.

Log, System-Benchmark, Verbindungs-Tuning, Server-Diversität

Ein Log-Betrachter direkt auf der Seite und die drei Selbstvermessungs-Tools aus Performance-Tools.

5 · Downloads hinzufügen

Kategorien, Prioritäten, Passwörter

• Kategorien sind freie Etiketten; jede wird zu einem Unterordner deines Download-Ordners, und Smarte Ordner (siehe §10) können sie per Regel zuweisen.
• Prioritäten: Erzwingen > Hoch > Normal > Niedrig. Erzwingen umgeht Pause und Quota.
• Passwörter für verschlüsselte Archive werden automatisch aus <meta type="password"> in der NZB oder einem Dateinamen Name{{password}}.nzb übernommen und lassen sich pro Job über die API oder nachträglich im Verlauf (🔑) angeben.

6 · Die Posterwand

Klick 🎬 Wand in der Kopfleiste. Die Wand macht aus deinem Index einen Medienbrowser: jedes erkannte Film- und Serien-Release als Poster-Kachel mit Bewertung, Jahr, Genres, Besetzung und Handlung - deine Newsgroups, durchstöberbar als Katalog.

• Reiter für Filme / Serien / Sonstiges, Sofortsuche und sieben Sortierungen: Für dich, Neueste Posts, Erscheinungsjahr, Top bewertet, Titel A–Z, Größte und Am meisten gepostet.
• Nur zugeordnete ist standardmäßig an und blendet unidentifizierten Müll aus; ein Chip „+N ohne Match“ zeigt ihn.
• Klick eine Kachel für das Detailblatt: Handlung, IMDb-Bewertung und -Stimmen, Besetzung - und ▶ Abspielen (sofort als Vorschau ansehen, siehe §7) oder ⬇ Download.
• ✎ Match korrigieren - hat ein Titel die falsche Serie oder den falschen Film erwischt, wähl den richtigen aus den Kandidaten-Postern, oder trag Titel/Jahr/Art von Hand ein. Manuelle Angaben überschreibt der Enricher nie. ↻ Metadaten erneuern lädt einen Titel neu; Einstellungen → Indexierung kann alle erneuern oder den ganzen Index löschen und neu aufbauen.
• Metadaten kommen standardmäßig ohne Key - TVmaze, iTunes, IMDb-Datensätze, Wikidata, Wikipedia und AniList brauchen keine Konten. Ein OMDb-Key (gratis, nur eine E-Mail-Anmeldung - ein Anmeldehelfer steckt in Einstellungen → Indexierung) verbessert das Film-Matching; ein TMDB-Key wird genutzt, falls du schon einen hast.
• Für dich ordnet die Wand nach einem Geschmacksprofil, das auf diesem Rechner aus deinem eigenen abgeschlossenen Verlauf und deiner Merkliste entsteht: bevorzugte Genres, ob du eher zu Film oder Serie neigst, und ungefähr welche Ära. Titel, die du schon hast, rutschen nach unten statt zu verschwinden, und eine Zeile „Weil du … schaust“ nennt den Grund. Ohne Verlauf fällt die Sortierung auf Am meisten gepostet zurück, der Reiter ist also nie leer. Nichts davon verlässt den Daemon.
• Kein Interesse auf einer Kachel blendet den Titel aus, und wer ein paar ähnliche ausblendet, bringt der Wand etwas bei: sie schlägt einen Filter vor, den ein Klick übernimmt („Alle Reality-Titel ab jetzt ausblenden?“). Alles Ausgeblendete und jeder gelernte Filter steht unter Ausgeblendet & Filter und lässt sich dort zurücknehmen.
• Ein kleiner Verfügbarkeitspunkt auf einer Kachel ist das Urteil des Orakels (§13): gelbes „?“ heißt unsicher bei deinen Providern, rot heißt, die Teile fehlen immer wieder. Ganze Gruppen, die gerade abgeräumt werden, tragen ein abgeräumt-Abzeichen.

7 · Vorschau & Prüfen

Du musst nicht warten, bis ein Download fertig ist, um zu wissen, dass es die richtige Datei ist. Öffne sie, während sie lädt, prüfe, ob Inhalt, Sprache und Qualität deinen Erwartungen entsprechen, und brich früh ab, wenn nicht - statt es erst nach dem kompletten Download festzustellen.

• ▶ Abspielen auf der Wand (oder /m3u/<id>) reicht deinem Medienplayer eine URL; der Daemon startet den Download dahinter oder nutzt den laufenden weiter.
• Der Endpunkt /stream/<nzo_id> liefert die Datei mit voller HTTP-Range-Unterstützung, während sie lädt. An jeder Stelle prüfen funktioniert: Spring stichprobenartig zu Minute 40 und die Artikel dieser Region werden an die Spitze der Download-Warteschlange befördert - es öffnet dort in ein paar Sekunden statt in Minuten. Kopf und Ende der Datei werden zuerst geholt, damit Player ihre Index-Daten sofort finden.
• Bibliotheks-Modus: In library_cats gelistete Kategorien werden zu sofortigen, reinen Metadaten-Einträgen - eine .strm-Datei erscheint sofort, die Verfügbarkeit wird im Hintergrund verifiziert, und der echte Download startet, wenn du sie zum ersten Mal öffnest.

8 · Usenet-Server

Einstellungen → Usenet-Server ist der volle Editor: hinzufügen, bearbeiten, entfernen, umsortieren und jeden Server in den Pool holen oder aus ihm herausnehmen. Jeder Server hat:

Zwei weitere Optionen pro Server haben noch kein Bedienelement im Dashboard: trage sie von Hand beim Eintrag dieses Servers in config.local.json ein (siehe §17) und starte neu.

• Das Häkchen neben jedem Server ist sein Ein/Aus-Schalter: gesetzt heißt, der Server ist im Download-Pool, nicht gesetzt heißt deaktiviert. Ein deaktivierter Server behält Zugangsdaten und Einstellungen und lässt sich weiterhin testen; er wird nur nie nach Artikeln gefragt. Seine Zeile wird blass, die Zählung in der Überschrift (2 von 3 aktiv) sinkt, und die Änderung gilt ab dem nächsten Download. Praktisch, um ein Block-Konto zu schonen, das du aufsparst, oder um einen Provider als Ursache eines Problems zu überführen, ohne ihn zu löschen.
• Verbindung testen macht einen echten Connect + TLS + Login und meldet die Round-Trip-Zeit.
• Aus SABnzbd / NZBGet importieren… durchsucht die üblichen Installationsorte, zeigt die Funde und übernimmt die Server (Duplikate werden übersprungen).
• Server-Änderungen gelten ab dem nächsten Download - kein Neustart.

9 · Einstellungs-Referenz

Fast alles lässt sich im Dashboard unter ⚙ Einstellungen konfigurieren; die vier Ausnahmen stehen am Ende dieses Abschnitts. Mit live markierte Werte gelten sofort, restart-Werte beim nächsten Start. Jede hier gemachte Änderung wird in settings.json gespeichert und übersteht Neustarts (UI-Werte schlagen Kommandozeilen-Flags).

Tempo & Zeitplan live

Nächster Download live

Verbindungen (pro Server), Fenster (Pipelining-Tiefe pro Verbindung), Decoder (parallele Decode-Threads). Wird beim Start jedes Jobs übernommen. Die Standardwerte passen für die meisten Leitungen; nutz die Tuning-Tools, bevor du blind erhöhst.

Schnellprüfung (CRC32) (standardmäßig an) belegt PAR2-Blöcke schon während des laufenden Downloads allein per CRC32, was auf einer langsamen CPU 2-3x schneller ist. Die eigene Prüfsumme jedes Artikels wird trotzdem geprüft, und der abschließende Durchgang rechnet immer volles MD5: an der Korrektheit ändert sich also nichts. Abwählen, um auch während des Downloads MD5 pro Block zu rechnen.

Festplatte & Quota live

Minimaler freier Platz (neue Jobs darunter pausieren), Download-Quota pro Tag oder Monat (UTC; Erzwingen-Jobs umgehen sie), Speicher-Budget - die RAM-Zuteilung der Engine (Standard: ¼ des RAM, gedeckelt; erhöh es auf einer Maschine mit viel RAM für maximales Tempo bei riesigen Jobs, und lies vor dem Senken, was wenig Speicher kostet) Neustart.

Fertige verschieben nach: nach dem Entpacken, Aufräumen und Umbenennen wandern fertige Downloads hierhin - ein NAS-Share, ein Medienlaufwerk, wohin auch immer deine Bibliothek gehört. Das Kategorie-Layout bleibt erhalten (ein Job, der unter tv/ fertig wurde, landet am Ziel unter tv/), und die History folgt dem Umzug, sodass verbundene Apps am neuen Ort importieren und löschen. Ist das Ziel beim Abschluss eines Jobs nicht erreichbar (Share offline, kein Platz), bleiben die Dateien im Download-Ordner und der Job wird trotzdem normal abgeschlossen. Leer = aus. Ziele je Kategorie leiten einzelne Kategorien woandershin (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); jeder gelistete Pfad ist der Ordner dieser Kategorie, es wird also kein zusätzlicher Kategorie-Unterordner darin angelegt. Nicht gelistete Kategorien folgen Fertige verschieben nach.

Verschachtelte Archivtiefe (Standard 5) ist die Zahl der Archiv-im-Archiv-Ebenen, die automatisch entpackt werden: ein RAR-Satz, der ein 7z enthält, das wieder ein RAR enthält, ist im Usenet normal, und nzbfast folgt der Kette ohne zweiten Durchgang. An der Grenze bleibt das tiefste Archiv einfach liegen, nicht weiter entpackt, und der Download wird trotzdem fertig. Nur für ungewöhnlich tiefe Releases erhöhen.

Auto-Umbenennen & Aufräumen live

Fertige Downloads umbenennen (standardmäßig an) gibt dem Ordner und der Hauptdatei einen sauberen, aussagekräftigen Namen: aus einem Film wird Example Movie (2024), Serien behalten Show - S01E02. Verschleierte oder unerkannte Namen bleiben exakt so, wie sie gepostet wurden, statt geraten zu werden.

Die ganze Gruppe läuft nach Reparatur und Entpacken und vor Fertige verschieben nach, und wird für einen Job, der noch auf ein Passwort wartet, komplett übersprungen. Beide Löschschritte gelten nur für Releases, die als Film oder Serie erkannt wurden: eine Software-Nutzlast oder ein nicht einzuordnender (verschleierter) Satz wird nie ausgemistet.

Ordner & Verarbeitung

Download-Ordner Neustart, Watch-Ordner, Nachbearbeitungs-Skript (läuft nach jedem Job mit SABnzbd-kompatiblen Argumenten und SAB_*-Umgebung - bestehende SAB-Skripte laufen unverändert), Aufräum-Endungen (Müll-Dateien, die nach dem Abschluss gelöscht werden), Smarte Ordner und TV-Ablage (siehe §10).

Indexierung live

Bibliothek, Sicherheit, Oberfläche

Bibliothek: Kategorien, die als sofortige Bibliothekseinträge behandelt werden, + Prüfintervall. Sicherheit: der volle API-Key (alles) und der NZB-Key (nur Hinzufügen - bedenkenlos an Indexer-Seiten zu geben), beide live rotierbar. Oberfläche: Klick-Sounds, Desktop-Benachrichtigungen bei Abschluss, Provider-Sortierintervall.

Tempo-Einheiten live bestimmt, wie jede Geschwindigkeit im Dashboard angezeigt wird: Megabyte (MB/s, die Norm bei Download-Managern, Standard) oder Megabit (Mb/s, wie Provider Leitungen angeben). Dateigrößen bleiben in Byte. Das ist eine Eigenschaft des Daemons, nicht deines Browsers, gilt also für jedes Gerät, das auf diese Installation schaut.

Fortgeschritten: Einstellungen ohne Bedienelement

Vier Einstellungen haben weder ein Bedienelement noch ein Kommandozeilen-Flag. Setze sie über die API (§16), z. B. /api?mode=config&name=verify_mode&value=lean&apikey=…. Wie alle anderen landen sie dauerhaft in settings.json.

10 · Automatisierung

Watchlist

Die einfachste Automatisierung: Titel im Dashboard hinzufügen, Qualitätsvorlieben setzen, fertig. Neue Releases werden geholt, sobald sie in deinen indexierten Gruppen auftauchen; Kopien in besserer Qualität ersetzen frühere Grabs; eine Kalenderansicht zeigt, was ansteht.

RSS-Feeds

Einstellungen → RSS: jede newznab-/Indexer-RSS-URL, mit Intervall, Kategorie und Filterregeln pro Feed (Titelmuster, Größengrenzen). Passende Einträge werden automatisch geladen.

Smarte Ordner

Regeln, die beim Hinzufügen eines Jobs ausgewertet werden: nach Muster/Stichwörtern und Größe matchen, eine Kategorie zuweisen (der erste Treffer gewinnt). Mit eingeschalteter TV-Ablage werden fertige Serien-Episoden umbenannt und abgelegt als Show/Season 01/Show - S01E02.mkv - bereit für Plex/Jellyfin, ganz ohne externes Tool.

Zeitplaner

Der Wochenplan (siehe §9) automatisiert Pause/Fortsetzen/Tempo nach Tageszeit.

Skripte

Ein Nachbearbeitungs-Skript bekommt SABnzbds Positionsargumente und SAB_*-Umgebungsvariablen - das große Ökosystem an SAB-Skripten läuft unverändert.

11 · Sonarr, Radarr & Co.

nzbfast spricht die SABnzbd-API nativ, also funktioniert jedes *arr out of the box - und es kann obendrein ihr Indexer sein.

Als Download-Client

1. In Sonarr/Radarr: Settings → Download Clients → SABnzbd hinzufügen.
2. Host: deine nzbfast-Maschine · Port: 6789 · API-Key: dein voller API-Key (Einstellungen → Sicherheit; das QR-/Kopier-Element ist gleich daneben).
3. Kategorie nach Wunsch (z. B. tv / movies). Test → grüner Haken → Save.

Warteschlange, Verlauf, Status pro Job, „remove & delete“, Retry und Kategorie-Routing verhalten sich alle so, wie die *arrs es erwarten.

Als Indexer (newznab)

1. Settings → Indexers → Newznab hinzufügen.
2. URL: http://<host>:6789/ · API-Pfad: /api · Key: dein API-Key.
3. nzbfast beantwortet caps-, search-, tvsearch- und movie-Abfragen aus seinem eigenen Index deiner beobachteten Gruppen, und /getnzb/<id> reicht die NZB zurück.

12 · Handy & Fernsteuer-Apps

nzbfast implementiert beide großen Fernsteuer-Protokolle, also funktioniert fast jede Handy-/Tablet-App. Nimm das Protokoll, das deine App unterstützt:

Apps, die NZBGet sprechen (nzb360, LunaSea, NZB Unity…)

Die volle JSON-RPC-Oberfläche, die diese Apps nutzen, wird bedient: Status, Warteschlange mit Umsortieren/Pause/Löschen, Verlauf, NZB hinzufügen, Tempolimit, Pause/Fortsetzen, Log.

Apps, die SABnzbd sprechen

Das Dashboard auf deinem Handy

Öffne einfach http://<machine>:6789 in einem mobilen Browser - das ganze Dashboard und die Wand haben ein Touch-Layout. Das Panel Einstellungen → Fernzugriff zeigt die genauen URLs und einen QR-Code zum Scannen.

13 · Performance-Tools

System-Benchmark

Ein Klick misst deine drei Limits - Netzwerk-Durchsatz (eine echte 8-Sekunden-Messung über mehrere Verbindungen), CPU-Prüfrate und Festplatten-Schreibtempo - und stellt die Antwort voran: deine erwartete maximale Download-Geschwindigkeit und welches Limit die Grenze ist. Der kürzeste Balken ist dein Flaschenhals; die anderen zeigen ihre Reserve. Plane ihn ein (6-stündlich → wöchentlich) und jeder Lauf landet in einer Verlaufstabelle, sodass du siehst, wann Provider, ISP oder Hardware ihr Verhalten geändert haben. Geplante Läufe passieren nur, während die Warteschlange ruht.

Verbindungs-Tuning

Misst einen Provider bei steigender Verbindungszahl und empfiehlt eine Einstellung - mehr Sockets helfen, bis der Provider oder deine Leitung dichtmacht, und manche Provider bestrafen zu viel Fragerei. Alle testen vergleicht jeden Provider und lässt sie dann alle zusammen bursten, um zu prüfen, ob der Pool deine Leitung auslastet.

Server-Diversität

Nimmt per STAT Artikel-Stichproben über alle Alter auf jedem Server und gruppiert Provider nach gemeinsamen Lücken: Provider mit ~100 % gemeinsam fehlenden Artikeln sind dasselbe Backbone (redundant für die Reparatur); unabhängige erweitern deine Abdeckung wirklich. Endet mit einer Empfehlung in Klartext.

Automatische Warteschlangen-Intelligenz

• Auto-Zurückstellen: Ein Download, der an einem einzelnen langsamen Server humpelt, während andere Jobs warten, wird ans Ende geparkt (das Journal bewahrt seinen Fortschritt) und erneut versucht, sobald die Warteschlange frei ist.
• Prefetch auf freien Servern: Server, die dem aktiven Job nicht helfen können (ihre Kopien sind weg), laden derweil schon den nächsten eingereihten Job. Kein anderer Client überlappt Jobs so.
• Job-übergreifendes Ausklingen: Während der Schwanz eines fertigen Jobs (Prüfen/Entpacken) auf der Festplatte ausläuft, gehört die Leitung schon dem Download des nächsten Jobs.

Das Verfügbarkeits-Orakel

Takedowns sind der Hauptgrund, warum ein Usenet-Download scheitert, und sie sind vorhersagbar: dasselbe Release verschwindet auf einem Backbone, während ein anderes es noch hat. nzbfast führt ein kleines Register darüber, was deine eigenen Provider tatsächlich geliefert haben, und gibt ein winziges Leerlaufbudget an STAT-Proben aus (ein paar Hundert pro Stunde und Server, nie während eines Downloads), um es aktuell zu halten. Nutzlast lädt es dafür nie.

Was du davon hast:

• Ein Verfügbarkeitsurteil auf Wand-Kacheln und Index-Zeilen (§6): gelbes „?“ für unsicher bei deinen Providern, rot für zuversichtlich weg. Kein Zeichen heißt, es sieht gut aus.
• Ein abgeräumt-Abzeichen bei Gruppen, in denen frische Posts schon wieder entfernt werden: so unterscheidest du eine sterbende Gruppe von einem Pechtreffer.
• Provider überspringen, die laut Orakel nichts mehr haben (Einstellungen, standardmäßig aus, experimentell): ist die Prüfung sicher, dass ein Backbone ein Release verloren hat, wird dieser Provider für den Download gleich übersprungen, statt auf sein Scheitern zu warten. Deinen letzten verbliebenen Provider überspringt er nie.

Das Urteil ist eine Vorhersage aus Indizien, keine Garantie. Für eine harte Antwort zu einer NZB zählt nzbfast check (§15) die tatsächlichen Artikel.

Speicher-Budget - und was wenig Speicher kostet

Alle Engine-Caches teilen sich ein Budget (Standard ¼ des physischen RAM, gedeckelt auf 256 MB–16 GB). Setz es explizit mit dem Speicher-Budget in den Einstellungen oder mit --mem-limit auf der Kommandozeile.

nzbfast ist gebaut, um dein Netzwerk und deine Festplatte gleichzeitig auszulasten, und RAM ist das, was beides in einem Durchgang möglich macht: Artikel werden dekodiert, geprüft und direkt an ihre endgültigen Offsets geschrieben, sodass Archiv-Volumes die Festplatte nie berühren müssen. Hungere es aus und nichts geht kaputt - jeder Cache hat einen Ausweich-Pfad, und die Engine weicht auf mehr Festplatten-I/O aus, statt zu swappen oder zu scheitern. Aber dieses Ausweichen ist nicht gratis, und bei großen Jobs kannst du es messen.

Gemessen auf einer Maschine und einer Leitung (M1 Ultra, 10 GbE), dieselben Dateien bei jedem Budget. Jeder Lauf lieferte ein korrektes, voll verifiziertes, entpacktes Ergebnis:

Der Spitzenverbrauch folgt dem Budget, nicht dem Job: Dieser 190-GB-Download läuft in etwa 1,1 GB RAM durch. Was du dafür eintauschst, ist Zeit - und nur bei großen Jobs.

• Bis ~35 GB ist wenig Speicher gratis. Das Arbeitsset passt sowieso, also ist eine 4-GB-Maschine mit so einem Job genauso schnell fertig wie eine mit 64 GB.
• Ab ~87 GB zahlst du 20–40 % - aber nur, wenn deine Leitung deiner Festplatte davonläuft. Prüfblöcke und Archiv-Volumes, die im RAM geblieben wären, werden stattdessen rausgeschrieben und wieder eingelesen, und das kostet nur dann Zeit, wenn das Netzwerk schneller liefern kann, als die Festplatte den Zusatzverkehr wegsteckt. Die 20–40 % oben wurden auf 10 GbE gemessen; derselbe 87-GB-Job mit denselben Budgets auf einer ~2,4-Gbps-Leitung zeigte überhaupt keine Strafe (−1 bis +7 %, im Rauschen der Läufe). Die Strafe hängt davon ab, wie weit die Leitung der Festplatte davonläuft, nicht von der Job-Größe - auf einem typischen Heimanschluss ist ein kleines Budget selbst bei sehr großen Jobs nahezu gratis.
• Die Strafe flacht ab. Sobald ein Job groß genug ist zu spillen, spillt jedes beschränkte Budget etwa gleich viel - die Läufe mit 2 GB, 1 GB und 256 MB lesen im Kern gleich viele Blöcke von der Festplatte zurück und liegen im Rauschen beieinander. Ein bisschen mehr RAM unterhalb der Schwelle, ab der gar nicht mehr gespillt wird, kauft die Kosten also nicht zurück: Gib ihm genug, um den Job im Speicher zu halten - sonst ist die genaue Zahl fast egal.

Auf einem kleinen NAS senk neben dem Budget auch die Verbindungen (2–4). Bei 256 MB Budget und 2 Verbindungen bleibt der Spitzenverbrauch nahe 190 MB - bequem innerhalb dessen, was ein 2-GB-NAS übrig hat. Sei dir bewusst, dass dann die Verbindungszahl limitiert, nicht der Speicher: Derselbe 35-GB-Job brauchte 286 s statt 65 s. Das ist die ehrliche Form dieses Tauschs - er wird immer fertig, und zwar korrekt; er lastet nur die Leitung nicht aus.

Die Benchmarks werden für jedes Release neu gefahren; Methode und Zahlen pro Maschine werden neben den Ergebnissen veröffentlicht.

14 · Updates

• Updates sind reine Benachrichtigungen: nzbfast lädt sein eigenes Binary nie herunter und ersetzt es nie, und es enthält keinen Code, der das könnte. Gibt es eine neue Version, zeigt die Kopfzeile ⬆ v X verfügbar - herunterladen; der Chip führt zur offiziellen Download-Seite (der Link ist fest in der App, er kommt nie aus dem Update-Manifest). Installiere die neue Version genauso, wie du die aktuelle installiert hast.
• nzbfast prüft zweimal täglich auf neue Versionen. Schalte Auf Updates prüfen (Einstellungen) aus und es kontaktiert das Update-Manifest gar nicht mehr; eine leere Update-Check-URL bewirkt dasselbe.

15 · Kommandozeile

Alles, was der Daemon kann, ist auch skriptbar. Die Alltagsbefehle:

Außerdem verfügbar: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), make-release-nzb/make-test-nzb (Test-Fixtures). Jeder Befehl nimmt --config und --help. Dazu kommt post: lädt Dateien als yEnc-Artikel hoch und schreibt die passende NZB. Ein Betriebswerkzeug, es verlangt ein ausdrückliches --post-server und wählt nie selbst einen Server aus.

16 · API-Überblick

Basis-Endpunkt: http://host:6789/api?mode=…&apikey=…&output=json - SABnzbd-kompatibel, bestehende SAB-Integrationen funktionieren also unverändert. Zwei Keys: der API-Key (volle Kontrolle) und der NZB-Key (nur Hinzufügen: addfile/addurl).

17 · Dateien & Speicherorte

18 · Fehlerbehebung

nzbfast - dieses Handbuch liegt jedem Release bei. Die hier genannten Einstellungen, Endpunkte und Standardwerte passen zu der Version, mit der es ausgeliefert wurde.