⚡ 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-setup-<version>.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

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, en welke server hoeveel aan deze taak bijdroeg.
• 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 met status, grootte en locatie; 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.

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 of uit een bestandsnaam Name{{password}}.nzb, en kunnen per taak via de API worden meegegeven of achteraf vanuit Geschiedenis (🔑).

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:

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.

Snelle verificatie (CRC32) (standaard aan) claimt PAR2-blokken via CRC32 terwijl de download nog loopt, wat 2-3x sneller is op een trage CPU. De eigen controlesom van elk artikel wordt nog steeds gecontroleerd, en de afsluitende ronde gebruikt altijd volledige MD5: aan correctheid wordt niets ingeleverd. Vink uit om ook tijdens de download MD5 per blok te doen.

Schijf & quotum live

Minimale vrije ruimte (pauzeer nieuwe taken eronder), 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.

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

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. 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: instellingen zonder bediening in het dashboard

Vier instellingen hebben geen bediening in de interface en geen optie op de opdrachtregel. Zet ze via de API (§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 (Instellingen → Beveiliging; de QR-/kopieerknop staat ernaast).
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.

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.

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

17 · Bestanden & locaties

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.