NZBHydra2: Eine Suchmaske für alle Indexer

Wer mehr als zwei oder drei NZB-Indexer betreibt, weiß: Die eigentlichen Kosten sind nicht die Abos, sondern die Pflege. Jeder Indexer muss in Sonarr, Radarr und Lidarr einzeln konfiguriert werden — jede API-Key-Rotation, jeder neue Indexer, jede Limit-Änderung dreimal. NZBHydra2 reduziert das auf einen einzelnen Newznab-Endpoint, der Anfragen gleichzeitig an alle konfigurierten Indexer verteilt und die Ergebnisse zusammengeführt und dedupliziert zurückliefert.

Was NZBHydra2 macht

NZBHydra2 ist ein in Java geschriebener Meta-Suchaggregator. Automations-Tools — Sonarr, Radarr, Lidarr und ähnliche — werden auf eine einzige URL gerichtet, und NZBHydra2 übernimmt die Verteilung im Hintergrund. Es spricht die Standard-Newznab- und Torznab-APIs, sodass alles, was mit einem Indexer kommunizieren kann, auch mit NZBHydra2 kommunizieren kann.

Über die reine Aggregation hinaus übersetzt NZBHydra2 Media-IDs. Wenn Sonarr nach einer TVDB-ID sucht, gibt NZBHydra2 diesen Identifier an jeden Indexer weiter, der ihn unterstützt — bessere Treffer, ohne dass pro Indexer etwas konfiguriert werden muss.

Hinzu kommt Observability: NZBHydra2 protokolliert jede Suche und jeden Download, verfolgt Antwortzeiten und Trefferquoten pro Indexer und stellt diese Daten über ein integriertes Stats-Dashboard bereit. Nach ein paar Wochen Betrieb hat man ein klares Bild davon, welche Indexer wirklich liefern.

Integrationspunkte

• Download-Manager: SABnzbd und NZBGet für direkte NZB-Übergabe; Torrent-to-Folder für Torznab-Ergebnisse
• Media-Automation: Sonarr, Radarr, Lidarr, Readarr — NZBHydra2 als benutzerdefinierten Indexer mit lokaler URL und API-Key eintragen
• Torrent-Tracker via Jackett: Jacketts Torznab-Endpoints als Quellen hinzufügen, NZBHydra2 mischt sie mit Usenet-Indexern in einem Ergebnissatz
• Mobile Apps: nzb360 und ähnliche Tools, die Newznab sprechen

Multi-User-Modus mit benutzerspezifischen API-Keys und Zugriffskontrollen ist verfügbar, falls die Instanz geteilt wird.

Aktuelle Änderungen (April – Juni 2026)

Das Projekt pflegt einen regelmäßigen Release-Rhythmus. Ein paar Dinge, die in der Praxis relevant sind:

Indexer-Gruppierung (v8.7.0) ermöglicht es, das Indexer-Auswahlmenü in benannte Gruppen zu unterteilen. Wer ein Dutzend Indexer betreibt, aufgeteilt in allgemeine NZB-, Anime- und Blu-ray-Quellen, kann diese jetzt entsprechend beschriften statt durch eine flache Liste zu scrollen.

Gespeicherte Suchen mit Größen- und Altersfiltern (v8.8.2 / v8.8.3) — gespeicherte Suchen speichern und zeigen jetzt min/max Dateigröße und Alterseinschränkungen an. Wer Suchen vor v8.8.2 gespeichert hat, muss sie einmalig neu speichern, damit die neuen Felder übernommen werden.

Barrierefreiheit: Dark Theme für Dyschromatopsie (v8.8.0) — ein separates Dark Theme, das für Farbsehschwächen optimiert ist, unabhängig vom normalen Dark Mode.

CPU-Problem im Image-Cache behoben (v8.8.1) — ein Bug ließ den Image-Cache die CPU auslasten. Wer auf einer Version unter v8.8.1 läuft und erhöhte CPU-Last bemerkt, sollte aktualisieren.

Indexer-Listen-Pflege (v8.8.2) — animetosho wurde aus der eingebauten Indexer-Liste entfernt; ameNZB und BlurayNZB wurden hinzugefügt. Die eingebaute Liste ist eine Komfortoption — eigene Newznab-kompatible Indexer lassen sich weiterhin manuell ergänzen.

Season/Episode-Datenverlust behoben (v8.7.1) — eine Regression in v8.7.0 ließ Staffel- und Episodeninformationen bei TV-Suchen fallen. Noch am selben Tag gepatcht; wer kurz auf v8.7.0 war und unerwartet schlechte TV-Suchergebnisse hatte, kennt damit die Ursache.

Betrieb

NZBHydra2 wird als eigenständige Java-Anwendung und als Docker-Image ausgeliefert. Die meisten betreiben es in Docker neben den anderen Stack-Komponenten. Es gibt keine externe Datenbankabhängigkeit — standardmäßig wird eine eingebettete H2-Datenbank verwendet.

Die Web-UI läuft auf Port 5076. Der Einrichtungsassistent führt beim ersten Start durch das Hinzufügen von Indexern und das Verbinden eines Download-Managers. Die Newznab-URL für Sonarr und Co. lautet http://<host>:5076/api mit dem API-Key aus den NZBHydra2-Einstellungen.

Die Konfiguration liegt in einer einzigen nzbhydra.yml-Datei, was Backup und Migration vereinfacht.

Einordnung im Stack

NZBHydra2 ersetzt keine Indexer — es multiplext sie. Je mehr Qualitäts-Indexer eingebunden werden, desto besser die Trefferquote. Es ersetzt auch keinen Download-Manager; NZBs werden an SABnzbd oder NZBGet weitergeleitet. Es ist die Routing-Schicht zwischen Automations-Tools und der Indexer-Landschaft.

Wer mehrere Indexer ohne Aggregator betreibt, dem rechtfertigt allein der reduzierte Konfigurationsaufwand die Einrichtung — ein Ort für API-Keys, Limits und Indexer-Status statt einer pro Automations-Tool. Das Stats-Dashboard ist ein Nebeneffekt, der Indexer-Probleme — Ausfälle, Drosselung, nachlassende Suchqualität — aufdeckt, bevor sie als sichtbare Lücken in der Medienbibliothek ankommen.

Projekt-Repository: github.com/theotherp/nzbhydra2