⚡ nzbfast

De snelle Usenet-downloader - gebruikershandleiding

1 · Welkom

nzbfast downloadt van Usenet zo snel als je lijn, je providers en je machine toelaten - en meestal betekent dat zo snel als je lijn. Het is één op zichzelf staand programma: de engine, een webdashboard, een posterwall-mediabrowser, een ingebouwde indexer, realtime voorvertoning, native PAR2-herstel en native RAR-uitpakken zitten allemaal in één executable. Er hoeft verder niets geïnstalleerd te worden.

Wat het snel maakt is architectuur, geen tweaks:

• Pipelined NNTP - veel artikelverzoeken rijden rug-aan-rug over elke verbinding, zodat elke verbinding op volle snelheid blijft in plaats van round-trips uit te zitten.
• Een one-pass-pipeline - downloaden, verificatie en uitpakken overlappen. Archiefvolumes worden in de stream uitgepakt; bij een typische store-mode-post raken de RAR-bestanden je schijf nooit aan, dus de taak heeft 1× de releasegrootte nodig in plaats van 2×, en is klaar zodra de download klaar is.
• Multi-provider-unie - elke ingestelde server draagt bij; een artikel dat op de ene backbone ontbreekt wordt van een andere opgehaald. Trage of dode servers leggen de wachtrij nooit stil.
• Een geheugenbudget - de engine houdt zich aan een begrensd RAM-budget en wijkt zo nodig uit naar schijf. Hij laat je machine nooit swappen.

Gemeten tegen het hele veld op identieke hardware, taken en providers heeft nzbfast een download van 190 GB in zo'n 5 minuten afgerond op een 10 GbE-lijn - met de bekendste alternatieven 30–220% daarachter op dezelfde tests, voor zover ze die überhaupt afmaakten. De cijfers staan in §3.

2 · Snel aan de slag

macOS

1. Open nzbfast-<version>-macos.dmg en sleep NzbFast naar Apps (universeel: Apple Silicon + Intel).
2. Eerste start: macOS waarschuwt dat nzbfast nog niet door Apple genotariseerd is. Rechtsklik op de app → Open - of open Systeeminstellingen → Privacy en beveiliging, scrol omlaag en klik op Open toch. Dit is eenmalig.
3. Het app-venster toont het dashboard met een welkomstkaart - klik erop en voeg minstens één Usenet-server toe (host, poort 563, gebruikersnaam, wachtwoord). Meer servers toevoegen kan later in Instellingen.
4. Sleep een .nzb waar dan ook op het dashboard - of dubbelklik gewoon op .nzb-bestanden in de Finder. Downloads komen terecht in ~/Downloads/nzbfast. Afsluiten doe je via het menu; downloads gaan verder waar ze gebleven waren.

Liever geen app? De kale zip (binary + Start nzbfast.command-starter, dezelfde engine) werkt nog steeds als vanouds - de stappen staan hieronder bij "Vanuit een terminal".

Windows

1. Draai nzbfast-<version>-windows-x64-setup.exe. Hij installeert alleen voor jouw gebruiker (geen administratorwachtwoord). Omdat deze release nog niet code-signed is, kan SmartScreen "Je pc is beschermd" tonen - klik op Meer informatie → Toch uitvoeren.
2. nzbfast leeft in het systeemvak: dubbelklik op het tray-icoon (of kies Open dashboard in het rechtsklikmenu) om het dashboard te openen, en voeg daarna je Usenet-server toe via de welkomstkaart. Het tray-menu heeft ook Pauzeren/Hervatten, je downloadmap en Afsluiten.
3. Dubbelklikken op een .nzb-bestand zet hem in de wachtrij. Windows Defender kan eenmalig vragen of lokaal netwerkverkeer is toegestaan - sta het toe.

Liever een portable versie? De -windows-x64.zip werkt nog steeds: pak hem uit waar je wilt en dubbelklik op nzbfast.exe (of Start nzbfast.bat) voor de terminalwizard.

Vanuit een terminal (elk platform)

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

Je API-sleutel

Bij een echt nieuwe installatie maakt nzbfast zelf een API-sleutel aan zodra de daemon voor het eerst start, en toont hem één keer in een banner net onder het dashboardadres. Vanaf dat moment heeft elk verzoek die sleutel nodig, zodat het dashboard en de API niet openstaan voor alles wat de machine kan bereiken.

Wat je ermee moet doen, hangt af van hoe je nzbfast gestart hebt:

• De macOS-app, het Windows-systeemvak of serve --open: niets. Ze geven de sleutel door aan het browservenster dat ze openen, het dashboard onthoudt hem en je bent al ingelogd.
• Een browser die je zelf geopend hebt, of het dashboard op een telefoon of een andere computer: de pagina vraagt één keer om de sleutel en onthoudt hem daarna.
• Sonarr, Radarr, nzb360 en consorten: plak hem erin als hun SABnzbd- of NZBGet-sleutel (§11, §12).

De sleutel wordt bewaard in een bestand met de naam apikey naast je configbestand, dus hij blijft hetzelfde na een herstart en je kunt hem teruglezen wanneer je maar wilt. Op macOS en Linux is dat bestand alleen leesbaar voor het account waaronder nzbfast draait. Hij staat ook in de uitvoer van de daemon zelf, dus de Log-kaart van het dashboard heeft hem als de terminal al weggescrold is.

Wil je in plaats daarvan een eigen sleutel gebruiken? Typ hem bij Instellingen → Beveiliging; hij geldt meteen. Dat paneel wijzigt de sleutel maar toont de huidige nooit, dus lees het bestand apikey als je de gegenereerde waarde terug wilt zien. Wil je helemaal zonder sleutel draaien, omdat iets vóór nzbfast het inloggen al afhandelt, start hem dan met NZBFAST_OPEN=1 in de omgeving. nzbfast blijft dan open en zegt dat ook onomwonden bij het starten.

Welke machines de daemon überhaupt kunnen bereiken is een aparte keuze: serve --bind. De standaard is 0.0.0.0, oftewel elke netwerkinterface, want een NAS, een telefoon en een Sonarr op een andere computer moeten allemaal verbinding kunnen maken. --bind 127.0.0.1 beperkt het tot de machine waarop nzbfast draait, en dat is wat je wilt op een enkele desktop waar verder niets toegang nodig heeft.

3 · Hoe nzbfast werkt

Eerst wat vocabulaire, dan leest de rest van de handleiding makkelijk:

De pipeline draait download → decode → verificatie → uitpakken gelijktijdig. De Pipeline-kaart op het dashboard laat alle drie de banen tegelijk bewegen. Als de laatste byte binnenkomt is de verificatie al gedaan en het bestand al uitgepakt; de "nabewerkingstijd" van een typische taak is nul. Alleen als er gerepareerd moet worden, worden volumes alsnog op schijf gezet, ter plekke gerepareerd door de native GF(2¹⁶)-engine (hernoemde of byte-verschoven geobfusceerde data wordt gevonden en meegenomen door een glijdende blokscan) en opnieuw uitgepakt - allemaal automatisch.

Onderbroken downloads (crash, stroomuitval, kill -9) hervatten vanuit het artikeljournal: bytes die al op schijf staan worden nooit twee keer opgehaald. Het journal registreert waar de bytes van elk artikel fysiek terechtkwamen - ook bytes die rechtstreeks in het eindbestand zijn uitgepakt - dus een hervatting bouwt verder vanaf de lokale schijf en verifieert alles wat hij terughaalde eerst tegen de PAR2-blokmap voordat het wordt vertrouwd.

Hoe dat zich verhoudt

Gemeten tegen SABnzbd 5.0.4 en NZBGet 26.2 op dezelfde machine, dezelfde providers en dezelfde NZB's, geklokt tot een bruikbaar bestand - download, verificatie, reparatie en uitpakken allemaal meegerekend, want dán is de taak pas echt klaar:

Het gat is de nabewerking die de anderen na de laatste byte nog moeten doen. Beide concurrenten waren voor de vergelijking getuned, niet op standaardinstellingen gelaten - SABnzbd wordt met name met request-pipelining uit geleverd, wat hem duur komt te staan, dus die is aangezet.

Twee verschillen wegen net zo zwaar als de tijden:

• Schijfruimte. Eén pass heeft 1× de releasegrootte nodig; clients die archiefvolumes wegschrijven en daarna uitpakken hebben 2× nodig. Op een testmachine met 97 GB vrij was een taak van 87 GB hier in 3 m 08 s klaar en konden de andere twee helemaal niet draaien.
• Geheugen. Bij de taak van 190 GB was het piekgebruik 3,9 GB tegenover 9,3 GB bij SABnzbd - en nzbfast doet dezelfde taak in ongeveer 1 GB als je daarom vraagt (zie Geheugenbudget).

4 · Het dashboard

Open http://localhost:6789 (of het adres van je machine vanaf een ander apparaat - de telefoonlay-out past zich automatisch aan). Alles wordt live bijgewerkt, één keer per seconde. De kaarten, van boven naar beneden:

Kopbalk

• Het Snelheidslimiet-menu - vaste limieten, auto · wijkt voor LAN (een RTT-gestuurde modus die inschikt zodra iemand anders in huis de lijn nodig heeft), of onbeperkt.
• Pauzeer voor… - pauzeer alles voor 15 min/30 min/1 uur/3 uur met automatisch hervatten, of gebruik de knop Pauzeren voor een pauze zonder eindtijd. Pauzeren is direct: de actieve overdracht stopt binnen seconden en gaat later verder vanuit het journal, zonder iets te verliezen. (Taken met prioriteit Geforceerd blijven downloaden, SABnzbd-stijl.)
• Hier verschijnt een update-banner zodra er een nieuwe versie beschikbaar is (zie Updates).

Doorvoer

Live MB/s met een scrollende grafiek; de gestippelde watermerken markeren het hoog/laag van deze sessie, de vage lijn is een voortschrijdend gemiddelde. Daaronder toont een histogram hoe de snelheidsmetingen van de sessie verdeeld zijn - gemiddeld vs piek. Maak het venster breder en de grafieken tonen meer geschiedenis (tot een uur).

Stat-tegels

Gedownload deze sessie, wachtrijdiepte, aantallen voltooid/mislukt, pieksnelheid van de sessie.

Resources - één machine, vier plafonds

CPU, RAM (tegenover het geheugenbudget van nzbfast), schrijfsnelheid naar schijf en netwerk op één genormaliseerde grafiek, met echte waarden in de legenda en een waarschuwing bij weinig schijfruimte. Geen enkele andere NZB-client laat je dit zien; het bestaat om een punt te bewijzen - nzbfast trekt je lijn vol, niet je machine.

Pipeline - fasen overlappen

Drie banen: downloaden, verifiëren (gecontroleerde PAR2-blokken), uitpakken. Bij een gezonde taak bewegen ze alle drie tegelijk.

Providers

Per server de live snelheid, verbindingsbenutting, aandeel in het verkeer, GB deze sessie en een artikel-completionscore over de hele levensduur (gekleurd zodra een server onder de 98% zakt). Een gestapelde vlakgrafiek toont de bijdrage van elke provider door de tijd. Rijen hersorteren zich elke 10 s op live prestaties (instelbaar in Instellingen → Interface), zodat je snelste provider altijd bovenaan staat.

Wachtrij

• Sleep rijen om te herordenen (binnen een prioriteitsband - Geforceerd/Hoog gaat nog steeds voor); wijzig de prioriteit inline.
• Klik op een rij voor de detail-lade: voortgangsbalken per bestand, aantallen geverifieerde blokken, welke server hoeveel aan deze taak bijdroeg, en een regel "toegevoegd door" die zegt waar de taak vandaan kwam (watchmap, een gekoppelde app, de API…). Een knop Download de .nzb slaat het .nzb-bestand van de taak voor je op - nzbfast bewaart een eigen kopie, dus dit werkt voor elke taak, ook als het originele bestand allang weg is.
• Badges tonen bijzondere toestanden: uitgesteld (traag), prefetchen, gepauzeerd (zie Prestatietools).
• Een burn-down-grafiek volgt het totaal aan resterende GB in de wachtrij.

Index doorzoeken

Doorzoek alles wat de ingebouwde indexer uit je gescande groepen heeft gecatalogiseerd (zie Automatisering) en download met één klik - geen externe indexer nodig. De statusregel toont de scanvoortgang; Nu scannen forceert een ronde.

Watchlist

Voeg titels op naam toe - ook titels die nog niet gepost zijn. Zodra een passende release in de index verschijnt wordt hij automatisch opgehaald, met kwaliteitsvoorkeuren en upgraderegels (een betere versie vervangt een slechtere).

Geschiedenis

Recente downloads, één regel per stuk. Mislukte taken bieden Opnieuw proberen (gaat verder vanuit het journal). Versleutelde archieven tonen een 🔑-ontgrendelknop - voer het wachtwoord in en de taak maakt zichzelf ter plekke af. De verificatiegezondheidsstrook zet beschadigde PAR2-blokken per download uit - een oplopende staart betekent dat artikelen beschadigd binnenkomen. De lade van elke regel zegt wie de taak toevoegde en heeft dezelfde knop Download de .nzb als de wachtrij - handig om een release ergens anders opnieuw te downloaden, of om de .nzb bij een probleemmelding te voegen.

De kaart toont standaard tien downloads en de rest is één klik weg, via de knop ▤. Status, locatie en de reden van een mislukking zitten achter een klik op de regel zelf, zodat het gewone geval - wat klaar is, hoe groot, wanneer - leesbaar blijft zonder scrollen. Sleep in plaats daarvan de onderrand van de kaart om de lijst op een door jou gekozen hoogte te laten scrollen. History rows in Instellingen → Interface verandert die tien; omdat het een eigenschap van de daemon is en niet van je browser, geldt het voor elk apparaat dat naar deze installatie kijkt. Colour History names daarnaast kleurt voltooide namen groen en mislukte rood; uitgezet blijven de namen neutraal, en de gekleurde stip en de details van de regel zeggen nog steeds welke welke is.

Dataverbruik

Dagelijkse balken per provider en totalen voor Vandaag / 7 dagen / 30 dagen - onmisbaar voor accounts met een datalimiet en blokaccounts. Blokaccounts tonen het totale verbruik tegenover hun grootte.

Log, Systeembenchmark, Verbindingstuning, Serverdiversiteit

Een logviewer op de pagina zelf, plus de drie zelfmeet-tools die worden beschreven in Prestatietools.

5 · Downloads toevoegen

Categorieën, prioriteiten, wachtwoorden

• Categorieën zijn vrije labels; elke categorie wordt een submap van je downloadmap, en Slimme mappen (zie §10) kunnen ze op regel toewijzen.
• Prioriteiten: Geforceerd > Hoog > Normaal > Laag. Geforceerd negeert pauze en quotum.
• Wachtwoorden voor versleutelde archieven worden automatisch opgepikt uit <meta type="password"> in de NZB, uit een bestandsnaam Name{{password}}.nzb of uit het veld p= van een nzblnk-link, en kunnen per klus via de API of achteraf vanuit Geschiedenis (🔑) worden meegegeven.

nzblnk-links

Sommige boards, vooral Duitse en Nederlandse, publiceren een nzblnk:-link in plaats van een NZB-bestand. De post is versluierd, dus er is geen bestandsnaam om naar te linken. De link draagt in plaats daarvan een header, h=, die een zoeksleutel is en geen locatie, plus een optionele titel t=, wachtwoord p= en groep g=. Iemand moet de post eerst gaan vinden.

nzbfast zoekt de header eerst op in zijn eigen index, waarvoor helemaal geen netwerk nodig is, en pas als dat misgaat vraagt het de zoekindexers die je hebt ingesteld (Instellingen → Zoekindexers, §9), onder dezelfde dagbudgetten en dezelfde terugval als elke andere zoekopdracht. De titel wordt de klusnaam en het wachtwoord wordt automatisch aan de klus meegegeven.

• Plakken of slepen werkt op elke installatie, Docker en NAS inbegrepen: kopieer de link van het board en plak hem ergens op het dashboard.
• Aanklikken vereist dat het schema bij je bureaublad geregistreerd is. De app uit de macOS-DMG registreert het, en het Windows-installatieprogramma biedt het aan als taak: het vraagt eerst, en laat het schema met rust als NZB Monkey of NZBDonkey het al heeft. Het kale macOS-tarball, Homebrew en de Linux-installaties hebben geen bureaubladafhandeling: daar is plakken de weg naar binnen.
• Het oplossen is met opzet in snelheid begrensd. Een geregistreerd schema ligt één browserprompt verwijderd van elke pagina die je bezoekt, dus links zijn per minuut begrensd en alleen de eerste paar van een minuut mogen je indexers bereiken; daarna wordt er alleen uit de lokale index geantwoord.

6 · De posterwall

Klik op 🎬 wall in de kopbalk. De wall maakt van je index een mediabrowser: elke herkende film- en tv-release als postertegel met beoordeling, jaar, genres, cast en synopsis - je nieuwsgroepen, doorbladerbaar als catalogus.

• Tabbladen voor Films / Series / Overig, direct zoeken en zeven sorteringen: Voor jou, Nieuwste posts, Releasejaar, Best beoordeeld, Titel A–Z, Grootste en Meest gepost.
• Alleen gematcht staat standaard aan en verbergt niet-geïdentificeerde rommel; een chip "+N ongematcht" haalt hem tevoorschijn.
• Klik op een tegel voor het detailblad: synopsis, IMDb-beoordeling en -stemmen, cast - en ▶ Afspelen (meteen als voorvertoning bekijken, zie §7) of ⬇ Downloaden.
• ✎ Match corrigeren - matchte een titel de verkeerde serie of film, kies dan de juiste uit de kandidaatposters, of vul titel/jaar/soort handmatig in. Handmatige tekst wordt nooit door de verrijker overschreven. ↻ Metadata verversen haalt één titel opnieuw op; via Instellingen → Indexeren kun je alles verversen of de hele index wissen en opnieuw opbouwen.
• Metadata is standaard sleutelloos - TVmaze, iTunes, IMDb-datasets, Wikidata, Wikipedia en AniList hebben geen accounts nodig. Een OMDb-sleutel (gratis, alleen een e-mailadres - er zit een aanmeldhulpje in Instellingen → Indexeren) verbetert de filmmatching; een TMDB-sleutel wordt gebruikt als je er al een hebt.
• Voor jou rangschikt de muur op een smaakprofiel dat op deze machine wordt opgebouwd uit je eigen voltooide geschiedenis en je volglijst: favoriete genres, of je naar film of serie neigt, en ruwweg welk tijdperk. Titels die je al hebt zakken naar onderen in plaats van te verdwijnen, en een bijschrift «Omdat je … kijkt» zegt waarop het zich baseerde. Zonder geschiedenis valt het terug op Meest gepost, dus het tabblad is nooit leeg. Niets hiervan verlaat de daemon.
• Niet geïnteresseerd op een tegel verbergt die titel, en een paar soortgelijke verbergen leert de muur iets: hij stelt een filter voor dat je met één klik aanvaardt («Alle Reality-titels vanaf nu verbergen?»). Alles wat je hebt verborgen en elk geleerd filter staat onder Verborgen & filters en is daar ongedaan te maken.
• Een kleine beschikbaarheidsstip op een tegel is het oordeel van het orakel (§13): een amberkleurig «?» betekent onzeker bij jouw providers, rood dat de onderdelen steeds ontbreken. Groepen die worden leeggeruimd krijgen een opgeruimd-badge.

7 · Voorvertoning & verificatie

Je hoeft niet te wachten tot een download klaar is om te weten dat het het juiste bestand is. Open het terwijl het downloadt, controleer of inhoud, taal en kwaliteit zijn wat je verwachtte, en breek vroeg af als dat niet zo is - in plaats van het pas na de volledige download te ontdekken.

• ▶ Afspelen op de wall (of /m3u/<id>) geeft je mediaspeler een URL; de daemon start of hergebruikt de download erachter.
• Het endpoint /stream/<nzo_id> serveert het bestand met volledige HTTP-range-ondersteuning terwijl het downloadt. Op elk punt controleren werkt: controleer steekproefsgewijs minuut 40 en de artikelen voor dat stuk worden vooraan in de downloadwachtrij gezet - het opent daar doorgaans binnen een paar seconden in plaats van minuten. De kop en staart van het bestand worden als eerste opgehaald, zodat spelers hun indexdata meteen vinden.
• Bibliotheekmodus: categorieën in library_cats worden directe metadata-only items - er verschijnt meteen een .strm-bestand, de beschikbaarheid wordt op de achtergrond geverifieerd, en de echte download start wanneer je hem voor het eerst opent.

8 · Usenet-servers

Instellingen → Usenet-servers is de volledige editor: toevoegen, bewerken, verwijderen, herordenen en elke server in of uit de pool halen. Elke server heeft:

Laat wat ruimte onder de verbindingslimiet van je account. De verbindingen net onder de limiet zetten kost niets: de doorvoer vlakt al ruim voor de laatste een of twee verbindingen af, en Verbindingstuning (§13) komt er toch al onder uit. Die vrije plekken zijn wat een tweede apparaat, een ander programma of een nieuwe poging na een verbroken socket er nog door laat, in plaats van geweigerd te worden terwijl deze elke plek bezet houdt.

Hoe je providerwachtwoorden worden bewaard

Providerwachtwoorden in config.local.json zijn versluierd, niet versleuteld. Ze worden opgeslagen als obf1: gevolgd door een gecodeerde vorm, zodat het bestand niet als platte tekst leest als het opduikt in een schermafbeelding, een forumbericht, een bugrapport of op een scherm dat iemand anders kan zien.

Wees duidelijk over wat dat je wel en niet oplevert:

• Het is geen versleuteling en biedt geen enkele bescherming tegen wie het bestand heeft. De methode staat in onze publieke broncode en de decoder zit in nzbfast zelf, dus wie het bestand heeft haalt het wachtwoord er in seconden uit. Behandel het bestand precies zo geheim als je zou doen wanneer de wachtwoorden leesbaar waren.
• Het haalt het achteloze lek weg, en dat is het gewone lek. Configs worden veel vaker in supportdraadjes geplakt en op schermafbeeldingen vastgelegd dan dat ze van schijf worden gestolen.
• Een wachtwoord dat je zelf als platte tekst hebt ingetypt werkt gewoon. nzbfast leest beide vormen, dus met de hand bewerkte configs en imports uit andere clients gaan nooit stuk; bij de volgende keer opslaan schrijft het de versluierde vorm.
• Het bestand wordt bovendien alleen leesbaar geschreven voor het account waaronder nzbfast draait (modus 0600 op macOS en Linux).

Ter vergelijking: NZBGet en SABnzbd bewaren providerwachtwoorden allebei als leesbare platte tekst in hun configuratiebestanden. Wij vinden versluiering daar een kleine verbetering op, geen beveiligingsfunctie.

Waarom niet de systeemsleutelbos? macOS Keychain, Windows Credential Manager en de Linux secret services zouden echte bescherming geven, en misschien komen we er nog op terug. Twee dingen houden ons vandaag tegen. Toegang tot de sleutelbos hangt aan de identiteit van de applicatie, en nzbfast is nog niet ondertekend, dus de prompts en het gedrag na elke update zijn slecht. En een groot deel van de installaties is Docker, servers zonder scherm en NAS-apparaten waar helemaal geen sleutelbos bestaat, wat twee verschillende opslagpaden zou opleveren die correct moeten blijven. Eén goed begrepen formaat dat zich overal hetzelfde gedraagt is voorlopig de betere ruil.

Twee andere opties per server hebben nog geen bediening in het dashboard: zet ze met de hand bij de vermelding van die server in config.local.json (zie §17) en herstart.

• Het vinkje naast elke server is de aan/uit-schakelaar: aangevinkt betekent dat de server in de downloadpool zit, niet aangevinkt betekent uitgeschakeld. Een uitgeschakelde server behoudt zijn inloggegevens en instellingen en blijft testbaar; er worden alleen nooit artikelen aan gevraagd. De regel vervaagt, de telling in de kop (2 van 3 actief) daalt en de wijziging geldt vanaf de volgende download. Handig om een blokaccount te sparen, of om te bewijzen dat één provider een probleem veroorzaakt zonder hem te verwijderen.
• Verbinding testen doet een echte connect + TLS + login en rapporteert de round-trip-tijd.
• Importeren uit SABnzbd / NZBGet… scant de gebruikelijke installatielocaties, laat zien wat er gevonden is en neemt de servers over (duplicaten worden overgeslagen).
• Serverwijzigingen gelden vanaf de volgende download - geen herstart nodig.

9 · Instellingen-naslag

Bijna alles is instelbaar vanuit het dashboard, onder ⚙ Instellingen; de vier uitzonderingen staan aan het eind van deze sectie. Waarden met live gelden meteen; restart-waarden bij de volgende start. Elke wijziging hier wordt bewaard in settings.json en overleeft herstarts (waarden uit de interface winnen van opties op de opdrachtregel).

Snelheid & planning live

Volgende download live

Verbindingen (per server), venster (pipelining-diepte per verbinding), decoders (parallelle decodeerthreads). Wordt bij de start van elke taak uitgelezen. De standaardwaarden zijn goed voor de meeste lijnen; gebruik de tuningtools voordat je blind verhoogt.

Controle tijdens het downloaden kiest hoeveel er wordt gecontroleerd terwijl de gegevens binnenkomen. Volledig bevestigt elk PAR2-blok met MD5. Snel (de standaard) claimt blokken via CRC32, wat 2-3x sneller is op een trage CPU, en controleert nog steeds de eigen controlesom van elk artikel. Zuinig slaat die artikelcontrolesommen ook over zodra PAR2 een bestand dekt: schade komt dan een moment later boven, bij het blok. In alle drie gebruiken de afsluitende ronde en elke reparatie volledige MD5, en een download zonder PAR2-bestanden houdt zijn artikelcontrolesommen.

Schijf & quotum live

Minimale vrije ruimte (pauzeer nieuwe taken eronder; standaard 2 GB, 0 schakelt het uit), downloadquotum per dag of maand (UTC; taken met Geforceerd negeren het), geheugenlimiet - het RAM-budget van de engine (standaard: ¼ van het RAM, begrensd; verhoog hem op een machine met veel RAM voor maximale snelheid bij enorme taken, en zie wat weinig geheugen kost voordat je hem verlaagt) herstart.

Voltooide verplaatsen naar: na uitpakken, opschonen en hernoemen verhuizen voltooide downloads hierheen - een NAS-share, een mediaschijf, waar je bibliotheek ook staat. De categorie-indeling blijft behouden (een taak die onder tv/ klaar was, belandt op de bestemming onder tv/), en de geschiedenis verhuist mee, zodat gekoppelde apps op de nieuwe locatie importeren en verwijderen. Is de bestemming onbereikbaar wanneer een taak klaar is (share offline, schijf vol), dan blijven de bestanden in de downloadmap en wordt de taak toch gewoon afgerond. Leeg = uit. Bestemmingen per categorie sturen specifieke categorieën ergens anders heen (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); elk vermeld pad is de map van die categorie, er wordt dus geen extra categoriesubmap in aangemaakt. Niet-vermelde categorieën volgen Voltooide verplaatsen naar.

Diepte van geneste archieven (standaard 5) is hoeveel lagen archief-in-archief automatisch worden uitgepakt: een RAR-set met daarin een 7z met daarin weer een RAR is normaal op Usenet, en nzbfast volgt de keten zonder tweede ronde. Op de grens blijft het diepste archief gewoon liggen, niet verder uitgepakt, en de download wordt toch voltooid. Verhoog dit alleen voor ongewoon diepe releases.

Automatisch hernoemen & opschonen live

Voltooide downloads hernoemen (standaard aan) geeft de map en het hoofdbestand een schone, informatieve naam: een film wordt Example Movie (2024), series houden Show - S01E02. Versluierde of niet-herkende namen blijven precies zoals ze gepost zijn in plaats van geraden te worden.

De hele groep draait na reparatie en uitpakken en vóór Voltooide verplaatsen naar, en wordt volledig overgeslagen bij een taak die nog op een wachtwoord wacht. Beide verwijderstappen gelden alleen voor releases die als film of serie zijn herkend: een softwarepayload of een niet te classificeren (versluierde) set wordt nooit opgeruimd.

Verwijderde bestanden gaan naar de Prullenbak bepaalt wat "verwijderen" hierboven betekent. Staat het aan, dan verplaatst het opruimen bestanden naar de Prullenbak van het systeem, zodat een verkeerde inschatting van wat rommel was ongedaan te maken is; staat het uit, dan worden ze definitief verwijderd. Het staat standaard aan op macOS en Windows, waar de Prullenbak een plek is die je kunt zien en legen, en standaard uit op Linux, waar dat meestal niet zo is.

Mappen & nabewerking

Downloadmap herstart, watchmap, nabewerkingsscript (draait na elke taak met SABnzbd-compatibele argumenten en SAB_*-omgeving - bestaande SAB-scripts werken ongewijzigd), opruimextensies (rommelbestanden die na voltooiing worden verwijderd), Slimme mappen en tv-opbergen (zie §10).

.nzb-bestanden na oppakken bewaren (staat standaard uit) laat het originele .nzb-bestand in de watchmap staan nadat de taak in de wachtrij is gezet, in plaats van het naar de prullenbak te verplaatsen - voor verzamelaars, en om het bestand aan iemand te geven als een download misgaat. Een bewaard bestand wordt onthouden, ook na een herstart, en wordt niet opnieuw toegevoegd; sla het opnieuw op om het nogmaals te downloaden. Wat je ook kiest, de lade van elke taak heeft een knop Download de .nzb, zodat een kopie van de .nzb van elke taak nooit meer dan één klik weg is.

Indexeren live

Bibliotheek, Beveiliging, Interface

Bibliotheek: categorieën die als directe bibliotheekitems worden behandeld + het hercontrole-interval. Beveiliging: de volledige API-sleutel (alles) en de NZB-sleutel (alleen toevoegen - veilig om aan indexersites te geven), beide live te roteren. Elk van beide vakjes vervangt de sleutel waar het bij hoort zodra je het veld verlaat, en een leeg gelaten vakje houdt de sleutel die het al heeft. De API-sleutel heeft daarnaast Show, dat de huidige sleutel toont en kopieert zodat je hem in Sonarr, Radarr of NZB360 kunt plakken wanneer het je uitkomt, en Create new, dat een vervanger aanmaakt - de oude sleutel werkt onmiddellijk niet meer, dus alles wat al verbonden is moet de nieuwe krijgen. Beide zijn afhankelijk van de API-sleutel zelf: de NZB-sleutel voor alleen toevoegen kan hem niet lezen, en dat is precies het punt van die sleutel. Waar de sleutel bij een nieuwe installatie vandaan komt, zie §2. Interface: klikgeluiden, bureaubladmeldingen bij voltooiing, provider-hersorteerinterval.

Snelheidseenheden live bepaalt hoe elke snelheid in het dashboard wordt getoond: megabytes (MB/s, de norm bij downloadmanagers, de standaard) of megabits (Mb/s, zoals providers lijnen opgeven). Bestandsgroottes blijven in bytes. Dit is een eigenschap van de daemon, niet van je browser, dus het geldt voor elk apparaat dat naar deze installatie kijkt.

Geavanceerd: de knoppen achter de voor de hand liggende

Zes instellingen zonder optie op de opdrachtregel. Elk heeft nu een geavanceerde regel op de instellingenkaart waar hij bij hoort, en blijft via de API te zetten (§16), bijv. /api?mode=config&name=verify_mode&value=lean&apikey=…. Net als alle andere worden ze bewaard in settings.json.

10 · Automatisering

Watchlist

De simpelste automatisering: voeg op het dashboard een titel toe, stel kwaliteitsvoorkeuren in, klaar. Nieuwe releases worden opgehaald zodra ze in je geïndexeerde groepen verschijnen; versies van betere kwaliteit upgraden eerdere grabs; een kalender laat zien wat eraan komt.

RSS-feeds

Instellingen → RSS: elke newznab/indexer-RSS-URL met per feed een interval, een categorie en filterregels (titelpatronen, grootte-grenzen). Passende items worden automatisch gedownload.

Slimme mappen

Regels die worden geëvalueerd zodra een taak wordt toegevoegd: match op patroon/trefwoorden en grootte, wijs een categorie toe (de eerste match wint). Met tv-opbergen aan worden voltooide tv-afleveringen hernoemd en opgeborgen als Show/Season 01/Show - S01E02.mkv - klaar voor Plex/Jellyfin zonder externe tool.

Planner

Het weekschema (zie §9) automatiseert pauzeren/hervatten/snelheid op tijdstip.

Scripts

Een nabewerkingsscript krijgt SABnzbd's positionele argumenten en SAB_*-omgevingsvariabelen - het grote ecosysteem aan SAB-scripts draait ongewijzigd.

11 · Sonarr, Radarr & co

nzbfast spreekt de SABnzbd-API native, dus elke *arr werkt out of the box - en hij kan ook als hun indexer optreden.

Als downloadclient

1. In Sonarr/Radarr: Settings → Download Clients → voeg SABnzbd toe.
2. Host: je nzbfast-machine · Poort: 6789 · API-sleutel: je volledige API-sleutel (waar je hem vindt: §2).
3. Categorie naar wens (bijv. tv / movies). Test → groen vinkje → Save.

Wachtrij, geschiedenis, status per taak, "verwijderen & wissen", opnieuw proberen en categorierouting gedragen zich allemaal zoals de *arrs verwachten.

Als indexer (newznab)

1. Settings → Indexers → voeg Newznab toe.
2. URL: http://<host>:6789/ · API-pad: /api · sleutel: je API-sleutel.
3. nzbfast beantwoordt caps-, search-, tvsearch- en movie-queries uit zijn eigen index van je gescande groepen, en /getnzb/<id> levert de NZB terug.

12 · Telefoon & remote-apps

nzbfast implementeert beide grote afstandsbedieningsprotocollen, dus vrijwel elke mobiele/tablet-app werkt. Kies het protocol dat jouw app ondersteunt:

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

Het volledige JSON-RPC-oppervlak dat deze apps gebruiken wordt geserveerd: status, wachtrij met herordenen/pauzeren/verwijderen, geschiedenis, NZB toevoegen, snelheidslimiet, pauzeren/hervatten, log.

Apps die SABnzbd spreken

Het dashboard op je telefoon

Open gewoon http://<machine>:6789 in een mobiele browser - het hele dashboard en de wall hebben een touch-lay-out. Het paneel Instellingen → Externe toegang toont de exacte URL's en een QR-code om te scannen.

nzbfast van buitenaf bereiken

Er is geen inlogpagina, en dat is een bewuste keuze. Inloggen met een sessiecookie is een beveiligingsoppervlak dat je voor altijd moet onderhouden, en het zou nog steeds het zwakste slot zijn op alles wat aan het open internet hangt. nzbfast authenticeert in plaats daarvan met je API-sleutel, en accepteert die sleutel zowel in een request-header als in de URL (X-Api-Key, of Authorization: Bearer) - en juist dat laat iets ervoor de aanmelding netjes afhandelen.

Het eenvoudigst is om helemaal niets te publiceren. Installeer Tailscale op deze machine en op je telefoon: beide zitten dan in één privénetwerk, er staat niets open, je hoeft niets aan router of certificaat te doen, en Instellingen → Toegang op afstand toont een adres dat overal werkt zodra het Tailscale ziet draaien. Kies dit, tenzij je echt een publiek domein nodig hebt.

Heb je dat wel nodig, zet er dan een reverse proxy voor, geef die het certificaat en laat die de authenticatie doen. Start nzbfast met --bind 127.0.0.1 zodat de proxy de enige ingang is, en wijs de proxy naar http://127.0.0.1:6789:

# Caddy
example.com {
    reverse_proxy 127.0.0.1:6789
}

# nginx
location / {
    proxy_pass http://127.0.0.1:6789;
    proxy_set_header Host              $host;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Leg erbovenop wat je proxy biedt: basic auth, een forward-auth-dienst als Authelia of Authentik, of clientcertificaten. Eén ding verrast iedereen - Sonarr, Radarr en de telefoon-apps kunnen geen browser-login doorlopen, laat ze er dus langs. De meeste proxy's kunnen een verzoek met een geldige X-Api-Key-header doorlaten en de rest om authenticatie vragen.

13 · Prestatietools

Systeembenchmark

Eén klik meet je drie plafonds - netwerkdoorvoer (een echte meting van 8 seconden over meerdere verbindingen), CPU-verificatiesnelheid en schrijfsnelheid van de schijf - en opent met het antwoord: je verwachte maximale downloadsnelheid en welk plafond de limiet is. De kortste balk is je bottleneck; de andere tonen hun marge. Plan hem in (elke 6 uur → wekelijks) en elke run wordt in een geschiedenistabel gelogd, zodat je ziet wanneer je provider, ISP of hardware zich anders ging gedragen. Geplande runs draaien alleen als de wachtrij inactief is.

Verbindingstuning

Meet één provider bij oplopende aantallen verbindingen en adviseert de instelling - meer sockets helpen tot de provider of je lijn verzadigd raakt, en sommige providers straffen te veel vragen af. Test alles vergelijkt elke provider en burst ze daarna allemaal samen om te checken of de pool je lijn verzadigt.

Serverdiversiteit

STAT-bemonstert artikelen van verschillende leeftijden op elke server en clustert providers op gedeelde gaten: providers met ~100% gedeelde ontbrekende artikelen zijn dezelfde backbone (redundant voor herstel); onafhankelijke providers breiden je dekking echt uit. Eindigt met een aanbeveling in gewone taal.

Automatische wachtrij-intelligentie

• Auto-uitstel: een download die voortstrompelt op één trage server terwijl andere taken wachten wordt achteraan geparkeerd (het journal bewaart de voortgang) en opnieuw geprobeerd zodra de wachtrij vrij is.
• Prefetch op inactieve servers: servers die de actieve taak niet kunnen helpen (hun kopieën zijn weg) beginnen ondertussen aan de volgende taak in de wachtrij. Geen enkele andere client doet taakoverstijgende overlap.
• Taakoverstijgende soak: terwijl de staart van een voltooide taak (verifiëren/uitpakken) op schijf afrondt, heeft de download van de volgende taak de lijn al in bezit.

Het beschikbaarheidsorakel

Takedowns zijn de belangrijkste reden dat een Usenet-download mislukt, en ze zijn voorspelbaar: dezelfde release verdwijnt bij de ene backbone terwijl een andere hem nog heeft. nzbfast houdt een klein register bij van wat je eigen providers werkelijk geleverd hebben, en besteedt een minuscuul rustbudget aan STAT-peilingen (een paar honderd per uur per server, nooit tijdens een download) om het actueel te houden. Het haalt daarvoor nooit payload op.

Wat het je oplevert:

• Een beschikbaarheidsoordeel op muurtegels en indexregels (§6): amberkleurige «?» voor onzeker bij jouw providers, rood voor met zekerheid weg. Geen markering betekent dat het er goed uitziet.
• Een opgeruimd-badge bij groepen waar verse posts al worden weggehaald, zodat je een stervende groep kunt onderscheiden van een ongelukkige release.
• Sla providers over die volgens het orakel niets meer hebben (Instellingen, standaard uit, experimenteel): als de controle er zeker van is dat de backbone van één provider een release kwijt is, wordt die voor die download meteen overgeslagen in plaats van te wachten tot hij faalt. Je laatst overgebleven provider slaat hij nooit over.

Het oordeel is een voorspelling op basis van aanwijzingen, geen garantie. Voor een hard antwoord over één NZB telt nzbfast check (§15) de werkelijke artikelen.

Geheugenbudget - en wat weinig geheugen kost

Alle engine-caches delen één budget (standaard ¼ van het fysieke RAM, begrensd op 256 MB–16 GB). Stel het expliciet in met Geheugenbudget in Instellingen, of --mem-limit op de commandoregel.

nzbfast is gebouwd om je netwerk en je schijf tegelijk vol te trekken, en RAM is wat dat in één pass mogelijk maakt: artikelen worden gedecodeerd, geverifieerd en rechtstreeks naar hun definitieve offsets geschreven, zodat archiefvolumes de schijf helemaal niet hoeven te raken. Knijp het geheugen af en er breekt niets - elke cache heeft een spill-pad, en de engine wijkt uit naar meer schijf-I/O in plaats van te swappen of te falen. Maar die spill is niet gratis, en bij grote taken kun je hem meten.

Gemeten op één machine en één lijn (M1 Ultra, 10 GbE), dezelfde bestanden bij elk budget. Elke run leverde een correct, volledig geverifieerd en uitgepakt resultaat op:

Het piekgeheugen volgt het budget, niet de taak: die download van 190 GB voltooit in ongeveer 1,1 GB RAM. Wat je ervoor inlevert is tijd - en alleen bij grote taken.

• Tot ~35 GB is weinig geheugen gratis. De werkset past hoe dan ook, dus een machine met 4 GB rondt zo'n taak even snel af als een met 64 GB.
• Voorbij ~87 GB betaal je 20–40% - maar alleen als je lijn je schijf voorbijrent. Verificatieblokken en archiefvolumes die anders in RAM waren gebleven worden weggeschreven en teruggelezen, en dat kost alleen tijd als het netwerk sneller kan leveren dan de schijf het extra verkeer kan slikken. De 20–40% hierboven is gemeten op 10 GbE; dezelfde taak van 87 GB bij dezelfde budgetten op een lijn van ~2,4 Gbps liet helemaal geen straf zien (−1 tot +7%, binnen de ruis tussen runs). De straf is een functie van hoe ver de lijn de schijf voorbijrent, niet van de taakgrootte - op een doorsnee thuisverbinding is een klein budget zelfs bij heel grote taken vrijwel gratis.
• De straf vlakt af. Zodra een taak groot genoeg is om te spillen, spilt elk begrensd budget ongeveer evenveel - de runs met 2 GB, 1 GB en 256 MB lazen in wezen hetzelfde aantal blokken van schijf terug en eindigden binnen elkaars ruis. Een beetje extra RAM onder de drempel die spillen helemaal voorkomt koopt de kosten dus niet terug: geef hem genoeg om de taak in het geheugen te houden, of het exacte getal maakt nauwelijks uit.

Zet op een kleine NAS ook Verbindingen lager (2–4), samen met het budget. Bij een budget van 256 MB en 2 verbindingen blijft het piekgeheugen rond de 190 MB - ruim binnen wat een NAS met 2 GB overheeft. Besef dat op dat punt het aantal verbindingen, niet het geheugen, de beperking is: dezelfde taak van 35 GB duurde 286 s in plaats van 65 s. Dat is de eerlijke vorm van de afweging - hij maakt het altijd af, en correct; hij trekt alleen de lijn niet vol.

Benchmarks worden voor elke release opnieuw gedraaid; de methode en de cijfers per machine worden naast de resultaten gepubliceerd.

14 · Updates

• Updates zijn alleen een melding: nzbfast downloadt of vervangt zijn eigen binary nooit, en er zit geen code in die dat kan. Is er een nieuwe versie, dan toont de header ⬆ v X beschikbaar - download; de chip linkt naar de officiële downloadpagina (de link staat vast in de app en komt nooit uit het update-manifest). Installeer de nieuwe versie op dezelfde manier als de huidige.
• nzbfast controleert twee keer per dag op nieuwe versies. Zet Controleren op updates (Instellingen) uit en het benadert het update-manifest helemaal niet meer; een lege update-check-URL doet hetzelfde.

Bijwerken zonder je instellingen te verliezen

Eén regel geldt voor elke installatie: een update vervangt het programma, nooit je instellingen. Alles wat je hebt ingesteld - servers, paden, de API-sleutel, de wachtrij - staat in een handvol bestanden in één map (§17), en geen installatieprogramma, image-pull of pakketupgrade komt aan die map. Lijken instellingen na een update toch verdwenen, dan komt dat vrijwel altijd doordat de nieuwe installatie een andere, lege map leest, niet doordat er iets is verwijderd; de oude bestanden staan nog precies waar ze altijd stonden. §18 heeft de herstelstappen.

15 · Commandoregel

Alles wat de daemon doet is ook scriptbaar. De alledaagse commando's:

Ook beschikbaar: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), predb-seed (vult de pre-database met de tijd van voor het aanzetten van de feed), make-release-nzb/make-test-nzb (testfixtures). Elk commando accepteert --config en --help. Daar komt post bij: het uploadt bestanden als yEnc-artikelen en schrijft de bijbehorende NZB. Een operationeel gereedschap; het vereist een expliciete --post-server en kiest nooit zelf een server.

16 · API-overzicht

Basis-endpoint: http://host:6789/api?mode=…&apikey=…&output=json - SABnzbd-compatibel, dus bestaande SAB-integraties werken ongewijzigd. Twee sleutels: de API-sleutel (volledige controle) en de NZB-sleutel (alleen toevoegen: addfile/addurl). addnzblnk zit met opzet niet in de alleen-toevoegen set: een link oplossen kan afgerekende indexerquota kosten, en daar gaat een alleen-toevoegen sleutel niet over.

17 · Bestanden & locaties

Waar de instellingenmap staat, hangt af van hoe nzbfast is geïnstalleerd. Deze ene map bevat alles wat een back-up waard is:

En wat erin staat:

18 · Problemen oplossen

nzbfast - deze handleiding wordt met elke release meegeleverd. De instellingen, endpoints en standaardwaarden hierin horen bij de versie waarmee hij is meegeleverd.