⚡ 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

De welkomstkaart vraagt ook hoe je nzbfast wilt gebruiken, met vier antwoorden: een app zoals Sonarr of Radarr stuurt hem aan, overstappen van SABnzbd, overstappen van NZBGet, of gewoon jij, vanaf dit dashboard. Een antwoord kiezen verandert op zichzelf niets. Het toont een korte lijst om na te lopen - elke aanbeveling met de eigen naam van de instelling, de huidige waarde, de aanbevolen waarde en één regel waarom - en Toepassen zet alleen de regels die je aanvinkt. Elke regel is een gewone instelling die je daarna los weer terug kunt zetten, en dezelfde lijst blijft later beschikbaar onder Instellingen → Aanbevolen instellingen voor hoe je hem gebruikt.

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).

De kaart kan ook een lijst volgen die je in Plex bijhoudt. Voeg een lijstbron toe: koppel je Plex-account (je keurt een korte code goed op de eigen pagina van Plex, dus er bereikt nooit een wachtwoord nzbfast) of plak het adres van je Plex-watchlist. Behandel dat adres als een wachtwoord - iedereen die het heeft kan je lijst lezen - en daarom wordt het na het opslaan gemaskeerd. Gesynchroniseerde titels verschijnen als alleen-lezen regels naast je eigen titels. Een gekoppeld account ziet je hele lijst, dus een titel die je daar verwijdert wordt hier ook niet langer gevolgd (voltooide downloads blijven altijd staan); een adres toont alleen de nieuwste items, dus een ontbrekende titel kan er simpelweg afgeschoven zijn en er wordt niets verwijderd. Beide gedragingen zijn per bron om te zetten.

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.

Het dashboard indelen

Het dashboard is van u om in te delen. Vier handelingen, overal met dezelfde naam: een kaart Verplaatsen, Compact maken, het Formaat wijzigen of haar Verbergen. Elke keuze onthoudt de browser waarin u haar maakte, dus elk apparaat houdt zijn eigen indeling, en Lay-out resetten in Instellingen → Interface zet elke kaart, grootte en kolom terug zoals ze geleverd werden.

Lay-out aanpassen is de begeleide ingang, en de snelste manier om te zien wat een kaart kan. Open het via de bescheiden link net boven de eerste kaart, of via Instellingen → Interface, waar het de eerste knop is in de rij Dashboard-lay-out. Zolang het aan staat heeft elke verplaatsbare kaart een omlijning, worden de drie gereedschappen in de titelregel op volle sterkte getekend met hun woord naast het pictogram, en wordt elke formaatbalk in de accentkleur getekend; een kaart zonder balk zegt op een eigen regel waarom, in plaats van u er een te laten zoeken. Klaar of de Escape-toets sluit het af. De modus is een manier van kijken naar de pagina en geen instelling: hij verandert niets aan uw indeling, en na een herlaadbeurt staat hij weer uit.

Op een dashboard dat nog niemand heeft ingedeeld zegt één regel boven de kaarten dat ze verplaatst, van formaat gewijzigd, compact gemaakt of verborgen kunnen worden, en wijst naar die link. Hij verschijnt één keer: Begrepen sluit hem, en dat doen ook de modus openen of wat dan ook indelen.

• Verplaatsen. Sleep een kaart aan haar titel. De hele kop is de greep, niet alleen het kleine pictogram links ervan, dus er is geen lastig doelwit te raken. Dat pictogram is ook een tabstop: geef het de aandacht en de pijltjestoetsen omhoog en omlaag verplaatsen de kaart.
• Compact. De knop naast de greep maakt de tussenruimte van die kaart kleiner: dezelfde cijfers, minder plaats. Bij Geschiedenis wisselt hij tussen de tien recentste downloads en de rest van uw geschiedenis. Compacte modus in Instellingen → Interface doet het hele dashboard in één keer.
• Formaat wijzigen. Een kaart met een lijst of een grafiek draagt een balk langs haar onderrand: sleep die tot de hoogte die u wilt. De balk is flauw tot u de kaart aanwijst, en tekent zich dan als een haarlijn over de volle breedte met ribbels in de achterste hoek; hij neemt ook toetsenbordaandacht, waar de pijltjes omhoog en omlaag de hoogte zetten en Shift een grotere stap maakt. Welke kaarten er een hebben verschuift naarmate kaarten eigen lijsten krijgen en verliezen: neem de balk als antwoord, niet een opsomming hier. In Lay-out aanpassen zeggen de kaarten zonder balk het zelf.
• Verbergen. De laatste knop in de titelregel verbergt die kaart. Verborgen kaarten verzamelen zich in een balk Verborgen onderaan het dashboard; klik daar op een naam om er een terug te halen.

Klik met rechts op de titel van een kaart voor dezelfde handelingen in één lijst: Omhoog, Omlaag, Compact, Formaat wijzigen en Verbergen, plus een ingang naar Lay-out aanpassen als u daar nog niet in zit. Formaat wijzigen wordt alleen aangeboden op een kaart die een balk heeft om te slepen. Omhoog en Omlaag vallen aan de uiteinden uit, en ze tellen alleen de kaarten die u ziet: een verborgen kaart wordt overgeslagen, dus eerste en laatste betekenen eerste en laatste zichtbare.

Dat menu is net zozeer een toetsenbordweg als een muisweg. Ga met Tab naar de greep van een kaart, druk op de Menu-toets of Shift+F10, en het opent onder de kop. De pijltjes omhoog en omlaag lopen erdoorheen en slaan alles over wat uitstaat; Escape sluit het en geeft de aandacht terug aan de greep waarvandaan u het opende. Formaat wijzigen kiezen geeft de aandacht aan de balk van die kaart, waar de pijltjes omhoog en omlaag de hoogte zetten en Shift een grotere stap maakt.

Escape sluit altijd alleen de bovenste laag. Het kaartmenu sluiten terwijl de modus aan staat laat de modus aan; een tweede Escape verlaat de modus.

Dashboardkaarten in Instellingen → Interface biedt dezelfde indeling als een gewone lijst bedieningselementen: een vakje Tonen per kaart, een vakje Compact ernaast, en de knoppen Omhoog en Omlaag. Op een telefoon, een tablet of elk smal venster staan de kaartgereedschappen en het slepen uit, want een kaart slepen over een pagina die onder uw vinger scrolt is een slechte bediening: daar deelt deze lijst het dashboard in. Zij schrijft wat het bureaublad leest, dus een volgorde die u op de telefoon zet is de volgorde die het bureaublad toont. Haar knoppen volgen de regel van het menu: ze vallen uit aan de uiteinden van de zichtbare kaarten, en een kaart die u verborgen hebt kan pas verplaatst worden als u haar weer toont.

Tabelkolommen worden ter plekke ingedeeld, niet vanuit het bovenstaande. Sleep in de tabellen van wachtrij, geschiedenis en index een kolomkop opzij om de kolom te verplaatsen, of de achterrand van de kop om haar te verbreden of te versmallen; dubbelklikken op die rand zet de breedtes terug. Met een kop in de aandacht verplaatsen de pijltjes links en rechts hem, en Shift met een pijltje wijzigt de breedte.

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.

Zoeken op je indexer-accounts

Heb je een account bij een NZB-indexersite, dan kan nzbfast daar vanaf hier zoeken en in de wachtrij zetten wat je kiest, in plaats van dat jij naar de site gaat, een NZB downloadt en die terugbrengt. Het spreekt de gangbare indexer-API die al die sites aanbieden, dus er valt niets per site in te stellen: NZBGeek, NZBFinder, DrunkenSlug, DOGnzb en de rest werken hetzelfde. Een Prowlarr- of NZBHydra2-instantie is ook één regel, en neemt elke indexer erachter meteen mee.

Een account toevoegen. Instellingen → Zoeken op indexers → + Indexer toevoegen. Vul een naam van je keuze in, het API-adres van de site (het gewone webadres volstaat; een Prowlarr-regel ziet eruit als http://host:9696/1/api) en de API-sleutel van je accountpagina daar, en dan Indexers toepassen. Testen vraagt de site wat hij ondersteunt en toont wat er terugkwam, waarmee adres en sleutel in één klik bewezen zijn. Een opgeslagen sleutel wordt nooit meer getoond: het vak zegt dat, en leeg laten houdt de sleutel die er al staat.

Zoeken. Open 🎬 wall in de kopbalk en schakel over naar de releaselijst. Het uitklapmenu naast het zoekvak bepaalt waar een zoekopdracht kijkt: Deze index, dus wat deze machine zelf gescand heeft, Indexers, of Beide. Je keuze wordt onthouden. Je accounts bevragen vraagt om iets in het vak, want ze met een lege opdracht doorbladeren zou het dagbudget uitgeven aan een lijst waar niemand om vroeg. Met de ingebouwde indexer uit, zoals nzbfast binnenkomt, zijn er geen posters te tonen en is de pagina precies dit: een zoekvak, je accounts en de resultaten.

De resultaten. Eén regel per release, de nieuwste bovenaan, met grootte, ouderdom en hoe vaak de gebruikers van die indexer hem gepakt hebben. Een release die meerdere van je accounts voeren verschijnt één keer. Onder Beide wint een kopie die je eigen index al heeft en valt die van buiten af, want pakken wat je al geïndexeerd hebt kost je niets. Downloaden zet hem met hoge prioriteit in de wachtrij: nzbfast haalt de NZB zelf op, en vanaf dat punt is de taak als elke andere, met reparatie, uitpakken, categorieën en scripts ongewijzigd.

Naar één titel vragen. Open de kaart van een titel op de wall en druk op ⌕ Zoek op mijn indexers. Voor films gaat de vraag via het IMDb-nummer overal waar de site er een aanneemt, en dat is het verschil tussen de film die je bedoelde en elke release waarvan de naam toevallig die woorden bevat. nzbfast zoekt dat nummer zelf op, dus de pagina houdt er nooit een. Sites zonder overeenkomst op nummer worden gewoon met woorden bevraagd.

Je tegoed. Indexer-accounts worden geteld: zoveel zoekopdrachten en zoveel downloads per dag, afhankelijk van je abonnement. Zet die twee getallen op de regel en nzbfast telt ertegen af, met een nieuwe start om middernacht UTC. 0, de standaard, betekent onbeperkt, en er wordt toch geteld. Een account dat zijn tegoed op heeft, zit de zoekopdracht uit terwijl de andere doorgaan, en een regel boven de resultaten noemt degene die is overgeslagen: opraken is nooit stil. Een site die met een eigen limiet antwoordt, of ons vraagt te vertragen, wordt een uur opzijgezet.

Waar je sleutel heen gaat. Alleen naar de indexer waar hij bij hoort. Sleutels blijven op deze machine, gaan nooit naar de browser - elke resultaatregel draagt in plaats van een link een bon die een half uur geldig is - en worden uit het log gehaald en uit elke fout die de site teruggeeft, zodat een geplakte foutmelding er geen kan lekken. Een download kan alleen een link ophalen die een van je eigen zoekopdrachten teruggaf.

Dit zijn dezelfde accounts waarop een nzblnk-link terugvalt als de lokale index zijn header niet kent, en die de watchlist over gewenste items kan bevragen (§10).

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 → Zoeken op indexers, §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.

De eerste helft daarvan staat al op de pagina. Open de regel van een download in de wachtrij (of in de geschiedenis) en de lade toont wat er in het videobestand zit, gelezen uit de bytes die tot nu toe zijn binnengekomen: resolutie, video- en audiocodecs, audiotalen, ondertitels, hoofdstukken. Een release die de verkeerde versie, de verkeerde taal of een upscale is, verraadt zichzelf in dat paneel lang voordat de download klaar is.

De pagina zoekt ook uit of deze browser het bestand kan afspelen, en zegt dat in plaats van te gokken: browsers verschillen (Safari decodeert HEVC waar Chrome dat niet doet, en vrijwel geen enkele decodeert AC-3- of DTS-audio), dus de vraag wordt gesteld aan de browser waar je daadwerkelijk in zit. Is het antwoord ja, dan opent ▶ Afspelen een speler direct op de pagina, die het bestand toont terwijl het downloadt. De meeste releases zijn MKV, dat veel browsers weigeren te openen terwijl ze alles erin wel kunnen decoderen, dus verpakt nzbfast die opnieuw tijdens het afspelen. Er wordt niets opnieuw gecodeerd: beeld en geluid zijn de oorspronkelijke bytes in een andere verpakking, en verspringen in het bestand werkt gewoon. Is het geluidsspoor er een die deze browser niet kan decoderen en draagt de release een tweede die hij wel aankan, dan speelt dat tweede spoor, zodat het beeld niet stil binnenkomt. Pas als de browser de decoder voor de video zelf mist, geeft de knop het bestand aan je eigen mediaspeler, zoals hieronder beschreven.

Eén instelling regelt dit allemaal: Instellingen → Interface → Een bestand controleren terwijl het downloadt. Alleen details, de standaard, toont het paneel en biedt geen speler op de pagina; Details en een speler voegt de speler toe; Uit zorgt dat het bestand helemaal niet wordt gelezen - staat dit uit, dan opent niets voor wie dan ook een half gedownload bestand.

Om in plaats daarvan in je eigen mediaspeler te controleren:

• ▶ 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.

Je hoeft de limiet op open bestanden van je machine niet te beheren. Het systeem telt elke verbinding als een open bestand, en macOS start een programma met een limiet van 256 daarvan, wat een volledige set verbindingen over meerdere servers kan overschrijden. Op macOS en Linux tilt nzbfast die limiet bij het starten zelf op: het vraagt om 65536 open bestanden en zakt via 16384, 4096 en 1024 tot het systeem akkoord gaat, nooit boven de harde limiet die het systeem stelt, en het gaat verder met de limiet die het had als elke stap wordt geweigerd. Windows kent geen limiet van dit soort per proces. Andere programma's houden het bij de limiet die de shell ze meegaf, en een programma dat halverwege een taak zonder open bestanden komt te zitten kan stoppen zonder in zijn log te zeggen waarom. Stel de verbindingen per server dus in op wat je abonnement toestaat, minus de ruimte hierboven, en niet op wat je denkt dat de machine aankan.

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.

Zoeken op indexers live

Je accounts bij NZB-indexersites, één regel per stuk, zodat een zoekopdracht op de wall ze ook kan bevragen. Wat de functie doet, en hoe je ermee zoekt, staat in §5.

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.

Een lijstbron voedt de watchlist vanuit een lijst die je in Plex bijhoudt, op een van twee manieren: koppel je Plex-account door een korte code goed te keuren op de pagina van Plex, of plak een Plex-watchlistadres. Het adres is een toegangssleutel - wie het heeft mag de lijst lezen - en daarom wordt het na het opslaan gemaskeerd. Het synchroniseren van verwijderingen verschilt bewust per modus: een gekoppeld account ziet de hele lijst, dus een daar verwijderde titel wordt hier niet langer gevolgd (al voltooide downloads blijven staan); een adresfeed bevat alleen de meest recente items, dus afwezigheid bewijst niets en titels worden alleen toegevoegd. Beide standaardinstellingen zijn per bron aan te passen.

Zoek ook op mijn indexer-accounts naar gewenste items, onderaan de watchlist-kaart, laat die naast je eigen index ook de accounts uit Instellingen → Zoeken op indexers bevragen (§5). Het begint uit, want het is het enige hier dat een afgerekend account uitgeeft zonder dat jij klikt. Aan vraagt elk gevolgd item ongeveer twee keer per dag, en alleen naar wat het nog niet gevonden heeft, onder dezelfde daglimieten en met dezelfde meldingen als een account wordt overgeslagen. Een kandidaat van een indexer wordt precies als een lokale beoordeeld, dus kwaliteitsdrempels, upgrades, seizoenpakketten en dubbelbehandeling gelden allemaal gewoon, en een lokale kopie wint elk gelijkspel omdat die geen tegoed kost. Met de ingebouwde indexer uit is dit wat de watchlist überhaupt iets geeft om mee te werken.

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. NZBGet's dialect wordt ernaast geleverd - NZBPP_*-variabelen (DIRECTORY, NZBNAME, CATEGORY, TOTALSTATUS, PARSTATUS, UNPACKSTATUS, FINALDIR) en de exitcodes 93/94/95 - zodat ook de kernlogica van een NZBGet-extensiescript draait. De koppeling is eerlijk in plaats van een emulatie: repareren en uitpakken gebeuren binnen de one-pass-download, dus een schone voltooiing meldt PARSTATUS=0 en een gerepareerde PARSTATUS=2. Optievormen per script (NZBPO_*) worden niet geleverd. Een script mag bij het afsluiten een helper op de achtergrond laten doorlopen en nzbfast zal die niet stoppen, maar nzbfast stopt wel met het lezen van de uitvoer van het script op het moment dat het script zelf klaar is: geef een helper op de achtergrond zijn eigen uitvoeromleiding, anders wordt hij gestopt zodra hij voor het eerst iets probeert te printen.

Pre-queue-script

Een tweede haak draait voordat een download de wachtrij ingaat (Instellingen → Mappen → Pre-queue-script), met SABnzbd's pre-queue-contract: argumenten name, pp, category, script, priority, size, group plus de SAB_*-omgeving. De eerste regel van zijn uitvoer accepteert (1) of weigert (0) de download; regels 2 tot 7 kunnen hem hernoemen, pp instellen, de categorie wijzigen, een script kiezen of de prioriteit wijzigen (lege regels houden de standaard). Een geweigerde download gaat als Mislukt met de reden naar de geschiedenis, en Opnieuw proberen vanuit de geschiedenis haalt hem terug zonder het script opnieuw te vragen. De haak kan nooit een download kwijtraken: als het script ontbreekt, crasht, zijn tijdsbudget overschrijdt of iets print dat geen oordeel is, gaat het toevoegen onaangeroerd door en zegt het log waarom.

Levenscyclus-events en ondertekende webhooks

Elke mijlpaal van een taak is een geversioneerd event: job.added, job.started, job.finishing, job.repaired, job.completed, job.failed, plus queue.idle, giveup.tripped, disk.low, storage.slow en quota.reached. Elk draagt schema_version (nu 1; nieuwe sleutels kunnen verschijnen zonder ophoging - negeer wat je niet kent), een monotone seq en een at-tijdstempel in milliseconden.

Om ze te ontvangen voeg je een webhook-notificatiedoel toe (Instellingen → Automatisering) en zet je in het events-veld de event-soorten die het moet krijgen - exacte soorten, of een prefix als job.*. Het doel krijgt dan één POST per event: de event-JSON als body plus een delivery-id (<boot>-<seq>, het handvat om op te ontdubbelen), de headers X-NzbFast-Event en X-NzbFast-Delivery, en - wanneer het doel een ondertekengeheim heeft - X-NzbFast-Signature: sha256=<hex>, een HMAC-SHA256 van de exacte body-bytes onder jouw geheim (dezelfde vorm die GitHub-webhooks gebruiken). Verifiëren in Python:

expected = "sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest()
ok = hmac.compare_digest(expected, request.headers["X-NzbFast-Signature"])

Bezorging is minstens-één-keer: een doel dat niet bereikbaar is wordt opnieuw geprobeerd na 10 s, 60 s en 5 min, en daarna losgelaten, met de mislukking zichtbaar op de instellingenregel van het doel. Een HTTP-foutantwoord (404, 401...) wordt niet opnieuw geprobeerd - repareer de ontvanger en gebruik Test. Elk doel heeft zijn eigen bezorgbaan, dus een doel dat traag of onbereikbaar is houdt nooit een ander op; binnen een baan houden bezorgingen de volgorde waarin de events gebeurden, en wordt er een losgelaten, dan tonen de volgnummers het gat. De klassieke event-woorden (completed, failed, repaired, disk, quota) houden op hetzelfde doel hun betekenis voor menselijke notificaties.

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.

Het dashboard reikt je het adres aan: op een installatie die nog niets heeft gedownload toont de route "Laat Sonarr, Radarr of een app downloads toevoegen" van de welkomstkaart het exacte adres met een Kopiëren-knop ernaast. De API-sleutel staat bewust niet op die regel; die blijft achter zijn eigen onthulknop in Instellingen → Beveiliging (§2).

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.

nzbfast kan ook zelf HTTPS serveren. Wijs Instellingen → Beveiliging → HTTPS-certificaat / HTTPS-privésleutel naar een PEM-certificaat en zijn sleutel (of start met --tls-cert cert.pem --tls-key key.pem), herstart, en het dashboard en de API antwoorden op https:// in plaats van gewoon HTTP - één listener, één schema. Gebruik het certificaat dat je domein al heeft (bijvoorbeeld van Let's Encrypt via certbot), of een zelfondertekend exemplaar voor het LAN, dat browsers na een eenmalige waarschuwing accepteren. Een kapot of verlopen certificaat weigert de start met het bestand erbij genoemd, zodat de fout zichtbaar is waar je hem maakte; vernieuwen doe je door de bestanden te vervangen en te herstarten. Native HTTPS versleutelt het verkeer maar voegt geen aanmelding toe, dus houd de API-sleutel ingesteld.

Heb je een publiek domein 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.
• Providers die het orakel afschrijft komen als laatste (Instellingen, standaard uit, experimenteel): als de controle er zeker van is dat de backbone van één provider een release kwijt is, wordt die provider bij die download als laatste gevraagd in plaats van als eerste. Er wordt niets verwijderd, dus een verkeerde inschatting kost wat tijd in plaats van de download.

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.