NZBHydra2 : un seul point de recherche pour tous vos indexers

Si vous utilisez plus de deux ou trois indexers NZB, vous savez que le vrai coût n’est pas dans les abonnements, mais dans la maintenance. Chaque indexer doit être configuré séparément dans Sonarr, Radarr et Lidarr ; chaque rotation d’API key, chaque nouvel indexer, chaque changement de limite se fait trois fois. NZBHydra2 ramène tout cela à un unique endpoint newznab qui distribue vos requêtes simultanément à tous les indexers configurés et renvoie des résultats fusionnés et dédupliqués.

Ce que fait NZBHydra2

NZBHydra2 est un agrégateur de méta-recherche écrit en Java. Vous pointez vos outils d’automatisation — Sonarr, Radarr, Lidarr et compagnie — vers une seule URL, et NZBHydra2 gère la distribution en arrière-plan. Il parle les APIs standard newznab et torznab, donc tout ce qui peut dialoguer avec un indexer peut dialoguer avec NZBHydra2.

Au-delà de l’agrégation brute, NZBHydra2 traduit les media IDs. Quand Sonarr cherche par TVDB ID, NZBHydra2 transmet cet identifiant à chaque indexer qui le supporte, améliorant la qualité des résultats sans aucune configuration par indexer de votre part.

Vous bénéficiez aussi d’une observabilité accrue. NZBHydra2 enregistre chaque recherche et chaque téléchargement, suit les temps de réponse et les taux de correspondance par indexer, et expose ces données via un dashboard de statistiques intégré. Après quelques semaines d’utilisation, vous avez une vision claire des indexers qui tiennent vraiment leurs promesses.

Points d’intégration

• Gestionnaires de téléchargement : SABnzbd et NZBGet pour la livraison directe de NZB ; torrent-to-folder pour les résultats torznab
• Automatisation des médias : Sonarr, Radarr, Lidarr, Readarr — ajoutez NZBHydra2 comme indexer personnalisé avec votre URL locale et votre API key
• Trackers torrent via Jackett : ajoutez les endpoints torznab de Jackett comme sources ; NZBHydra2 les mélange avec vos indexers Usenet dans un seul jeu de résultats
• Applications mobiles : nzb360 et outils similaires qui parlent newznab

Le mode multi-utilisateur avec API keys par utilisateur et contrôles d’accès est disponible si vous partagez votre instance.

Changements récents à connaître (avril – juin 2026)

Le projet maintient un rythme de publication régulier. Quelques éléments qui comptent en pratique :

Groupement d’indexers (v8.7.0) : permet d’organiser le menu déroulant de sélection des indexers en groupes nommés. Si vous avez une douzaine d’indexers répartis entre sources NZB générales, spécialisées anime et Blu-ray, vous pouvez maintenant les étiqueter en conséquence plutôt que de faire défiler une liste plate.

Recherches sauvegardées avec filtres de taille et d’âge (v8.8.2 / v8.8.3) : les recherches sauvegardées stockent et affichent désormais des contraintes de taille et d’âge min/max. Les recherches sauvegardées avant v8.8.2 doivent être ré-enregistrées une fois pour intégrer les nouveaux champs.

Accessibilité : thème sombre pour dyschromatopsie (v8.8.0) : un thème sombre dédié optimisé pour les déficiences de vision des couleurs, indépendant du mode sombre standard.

Correction de la consommation CPU dans le cache d’images (v8.8.1) : un bug faisait tourner le cache d’images à fond. Si vous êtes sur une version antérieure à v8.8.1 et constatez une CPU élevée, mettez à jour.

Maintenance de la liste d’indexers (v8.8.2) : animetosho a été retiré de la liste intégrée ; ameNZB et BlurayNZB ont été ajoutés. La liste intégrée est une facilité ; rien ne vous empêche d’ajouter manuellement n’importe quel indexer compatible newznab.

Correction de la perte de données saison/épisode (v8.7.1) : une régression introduite en v8.7.0 supprimait les informations de saison et d’épisode lors des recherches TV. Corrigé le jour même ; si vous êtes passé brièvement par v8.7.0 et obteniez des résultats inattendus pour du contenu TV, voilà la cause.

Comment le faire tourner

NZBHydra2 est distribué comme application Java autonome et comme image Docker. La plupart le font tourner dans Docker aux côtés des autres composants du stack. Il n’y a pas de dépendance externe à une base de données — il utilise par défaut une base H2 embarquée.

L’interface web tourne sur le port 5076. La configuration initiale guide à travers l’ajout d’indexers et la connexion d’un gestionnaire de téléchargement. L’URL newznab à donner à Sonarr et consorts sera http://<host>:5076/api avec l’API key de la page de configuration de NZBHydra2.

La configuration réside dans un unique fichier nzbhydra.yml, ce qui simplifie les sauvegardes et la migration vers un autre hôte.

Sa place dans le stack

NZBHydra2 ne remplace pas les indexers — il les multiplexe. Plus vous lui fournissez d’indexers de qualité, meilleur sera votre taux de correspondance. Il ne remplace pas non plus un gestionnaire de téléchargement ; il transmet les NZB à SABnzbd ou NZBGet. Considérez-le comme la couche de routage entre vos outils d’automatisation et l’écosystème des indexers.

Pour quiconque gère plusieurs indexers sans agrégateur, la seule réduction du travail de configuration justifie le temps d’installation — un seul endroit pour gérer les API keys, les limites et l’état des indexers au lieu d’un par outil d’automatisation. Le dashboard de statistiques est un bénéfice annexe qui tend à révéler les problèmes d’indexers — pannes, throttling, dégradation de la qualité de recherche — avant qu’ils ne se traduisent par des trous visibles dans votre bibliothèque.

Dépôt du projet : github.com/theotherp/nzbhydra2