Aller au contenu principal

Intégration domotique Sonarr, Radarr, Lidarr & co, gratuite et open source

Intégration Sonarr, Radarr, Lidarr & co pour Gladys Assistant

Sonarr, Radarr, Lidarr, Prowlarr, Bazarr : sorties, file, manquants, indexeurs, sous-titres.

Amenez votre Sonarr (séries), votre Radarr (films) et votre Lidarr (musique) dans Gladys, sur votre réseau local : les épisodes, films et albums qui sortent cette semaine sur le tableau de bord, avec leurs affiches, l'état des files de téléchargement, les manquants, les alertes de santé, et des scènes qui réagissent quand un épisode, un film ou un album est téléchargé.

L'intégration a été testée contre de vrais Sonarr 4, Radarr 6 et Lidarr 3 (les images Docker officielles), pas encore dans une vraie installation de Gladys : vos retours sont les bienvenus sur le forum Gladys ou dans les issues.

Ce qu'il faut​

  • Gladys Assistant 5.1.0 ou plus récent.

  • Sonarr v3 ou v4, Radarr v3 ou plus récent et/ou Lidarr v1 ou plus récent, joignables depuis Gladys (même réseau). Jusqu'à deux de chaque.

  • La clé d'API de chaque instance : dans Sonarr, Radarr ou Lidarr, Settings → General → Security → API Key.

  • En option, Prowlarr (v1 ou plus récent, un seul) et Bazarr (1.x, testé sur 1.6, un seul) : clé d'API dans Settings → General → Security → API Key.

Mise en route​

  1. Installez l'intégration depuis le catalogue de Gladys.
  2. Dans Configuration, section Sonarr, saisissez l'Adresse de votre Sonarr avec son port (par exemple 192.168.1.2:8989), sa Clé d'API, et si vous le souhaitez un Nom. De même dans la section Radarr (port 7878 par défaut) et la section Lidarr (port 8686). Un Sonarr derrière un proxy inverse avec une base d'URL ? Saisissez-la aussi : https://example.org/sonarr. Laissez vide la section d'une application que vous n'utilisez pas. Un deuxième Sonarr (4K, animés…), Radarr ou Lidarr ? Remplissez la section Deuxième… correspondante.
  3. Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton indique, pour chaque instance, si elle répond, sa version, sa file, ses manquants et ses alertes de santé.
  4. Ouvrez l'onglet Découverte : un appareil par instance. Cliquez sur Ajouter, choisissez une pièce, enregistrez.

Options :

  • Intervalle de rafraîchissement : fréquence de lecture des instances (file, calendrier, historique, santé), de 1 à 10 minutes (2 minutes par défaut). Chaque lecture fait 6 petites requêtes à chaque instance, 7 une fois par heure.
  • Langue des noms de fonctionnalités : anglais, français, allemand ou espagnol. Les noms sont donnés à l'ajout d'un appareil (français par défaut) ; la langue règle aussi la phrase de l'action de résumé.

L'appareil de chaque instance​

Toutes les fonctionnalités sont en lecture seule. Les noms parlent d'« épisodes » sur un Sonarr, de « films » sur un Radarr et d'« albums » sur un Lidarr.

FonctionnalitéCe que c'est
En ligne1 tant que l'instance répond, 0 sinon
File de téléchargementÉléments de la file de téléchargement (Activity → Queue)
Téléchargements en erreurÉléments de la file en avertissement ou en erreur : import bloqué, téléchargement en échec…
Épisodes manquants / Films manquants / Albums manquantsÉpisodes, films ou albums surveillés sans fichiers (Wanted → Missing)
Épisodes des 7 prochains jours / Films des 7 prochains jours / Albums des 7 prochains joursÉpisodes diffusés, films (cinéma, numérique, disque) ou albums qui sortent, d'aujourd'hui à J+6
Espace libreEspace libre des dossiers racine, en Go ; le plus petit s'il y en a plusieurs
Avertissements de santéAvertissements de System → Status (indexeur, client de téléchargement…)
Erreurs de santéErreurs de System → Status
VersionVersion de Sonarr, Radarr ou Lidarr

Prowlarr et Bazarr​

Deux sections facultatives de la configuration, une instance chacune : Prowlarr (indexeurs) (port 9696 par défaut) et Bazarr (sous-titres) (port 6767), avec les mêmes champs Adresse, Clé d'API et Nom. Ils ont chacun leur appareil dans l'onglet Découverte, et une ligne dans le widget. Testé contre de vrais Prowlarr 2.6 et Bazarr 1.6 (images Docker officielles).

L'appareil Prowlarr (4 petites requêtes par lecture, 5 une fois par heure) :

FonctionnalitéCe que c'est
En ligne1 tant que Prowlarr répond
Indexeurs actifsIndexeurs activés dans Prowlarr
Indexeurs en échecIndexeurs mis en pause par Prowlarr après des échecs (site en panne, connexion refusée, quota)
Requêtes (24 h)Requêtes envoyées aux indexeurs sur les dernières 24 heures
Récupérations (24 h)Releases récupérées via Prowlarr sur les dernières 24 heures
Avertissements de santéAvertissements de System → Status
Erreurs de santéErreurs de System → Status
VersionVersion de Prowlarr

L'appareil Bazarr (3 requêtes par lecture, 4 une fois par heure) :

FonctionnalitéCe que c'est
En ligne1 tant que Bazarr répond
Épisodes sans sous-titresÉpisodes en attente de sous-titres (Wanted → Series), comptés par Bazarr
Films sans sous-titresFilms en attente de sous-titres (Wanted → Movies)
Fournisseurs en échecFournisseurs de sous-titres mis en pause par Bazarr après une erreur (System → Providers)
Avertissements de santéProblèmes de System → Status (Bazarr ne leur donne pas de niveau : tous comptent comme avertissements)
VersionVersion de Bazarr

Le Seuil de sous-titres manquants de la section Bazarr (20 par défaut) est le nombre d'épisodes et de films sans sous-titres à partir duquel le déclencheur ci-dessous part.

Tableau de bord​

Ajoutez le widget Sorties à venir (les widgets de l'intégration, dans l'éditeur du tableau de bord). Par défaut il couvre toutes les instances ; son réglage Instance le limite à une seule.

Il affiche :

  • deux tuiles : les éléments En file et les Manquants, pour toutes les instances affichées ;
  • une grille des épisodes, films et albums qui sortent d'aujourd'hui aux 6 jours suivants, avec leur affiche (pour un album, celle de l'artiste), leur date, et un badge Téléchargé une fois le fichier là (pour un film, avant cela : Au cinéma, Numérique ou Blu-ray / DVD). Touchez une carte pour le titre de l'épisode ou de l'album et le résumé ;
  • une ligne par instance : file, téléchargements en erreur, alertes de santé, ou Injoignable ;
  • deux boutons : Chercher les manquants (comme l'action ci-dessous) et Rafraîchir.

Les affiches viennent de Sonarr, Radarr et Lidarr eux-mêmes (la petite copie qu'ils gardent), à travers Gladys : votre navigateur ne charge jamais d'adresse extérieure.

Scènes​

Déclencheurs​

DéclencheurQuandFiltresVariables
Épisode, film ou album téléchargéSonarr, Radarr ou Lidarr a importé un téléchargement terminé dans la bibliothèqueinstance, applicationnom de l'instance, titre, titre avec épisode, année ou artiste, qualité
Téléchargement en échecUn téléchargement a été marqué en échecinstance, applicationnom de l'instance, titre, titre avec épisode, année ou artiste, raison
Nouvelle alerte de santéUn avertissement ou une erreur apparaît dans System → Status (une fois, jusqu'à sa disparition)instance, application, niveaunom de l'instance, niveau, vérification, message

L'intégration lit l'historique de chaque instance à chaque rafraîchissement : un téléchargement est annoncé au plus un intervalle après l'import, une seule fois, même après un redémarrage. Les événements de plus d'une heure ne sont pas annoncés (Gladys arrêté une nuit ne rejoue pas la nuit). Les alertes de santé présentes à l'ajout d'une instance servent de point de départ : seules les nouvelles sont annoncées.

Pour Lidarr, le titre est celui de l'album, et le titre avec artiste donne « Radiohead – The King of Limbs ». Lidarr enregistre un import par piste : les pistes d'un album lues ensemble font un seul événement. Des pistes importées plus tard (une piste manquante, une amélioration de qualité) annoncent de nouveau l'album ; un album dont les pistes sont importées sur deux lectures (rare : un import prend quelques secondes) est annoncé deux fois.

Prowlarr et Bazarr ont leurs propres déclencheurs :

DéclencheurQuandFiltresVariables
Indexeur Prowlarr en échecProwlarr a mis un indexeur en pause après des échecsinstancenom de l'instance, indexeur, en pause jusqu'à (date ISO)
Indexeur Prowlarr rétabliProwlarr a levé la pause de cet indexeur (il va le réessayer)instancenom de l'instance, indexeur
Bazarr : sous-titres manquants au-delà du seuilLes épisodes et films sans sous-titres atteignent le seuil (une fois, jusqu'à repasser sous le seuil)instanceépisodes, films, total, seuil
Fournisseur de sous-titres Bazarr en échecBazarr a mis un fournisseur de sous-titres en pause après une erreurinstancenom de l'instance, fournisseur, raison, en pause jusqu'à

Le déclencheur Nouvelle alerte de santé couvre aussi Prowlarr et Bazarr (filtre d'application). Comme pour les alertes de santé, l'état trouvé à la première lecture d'une instance est le point de départ : un indexeur déjà en pause, ou des sous-titres déjà au-delà du seuil, ne sont pas annoncés.

Actions​

ActionCe qu'elle faitSorties
Chercher épisodes, films, albums ou sous-titres manquantsLance la recherche de tous les épisodes, films ou albums surveillés manquants, sur une instance ou toutesinstances ayant lancé la recherche
Rafraîchir la bibliothèque Sonarr, Radarr, Lidarr ou BazarrDemande le rafraîchissement des informations et fichiers de chaque série, film ou artiste (exécuté en arrière-plan par l'application)instances rafraîchies
Lire le résumé *arrConstruit une phrase : sorties de la semaine, file, manquants, alertes de santéphrase, sorties, éléments en file, manquants

Rien n'est jamais supprimé : l'intégration lit, et lance des recherches et des rafraîchissements.

Sur Bazarr, la recherche lance ses tâches « recherche des sous-titres manquants » (séries et films) et le rafraîchissement sa synchronisation avec Sonarr et Radarr ; ces tâches n'existent que si Sonarr ou Radarr est activé dans Bazarr. Prowlarr n'a pas de bibliothèque : les actions le sautent.

Idées de scènes​

  • Soirée film : déclencheur Épisode, film ou album téléchargé avec l'application Radarr, puis une notification qui reprend la variable Titre avec épisode (S01E02), année ou artiste : « Avatar (2009) est prêt ».

  • Nouvel album : déclencheur Épisode, film ou album téléchargé avec l'application Lidarr, puis une notification avec Titre avec épisode (S01E02), année ou artiste : « Radiohead – The King of Limbs est dans la bibliothèque ».

  • Résumé du matin : chaque jour à 8 h, Lire le résumé *arr, puis envoyer sa phrase sur Telegram ou la faire dire par l'enceinte.

  • Téléchargements bloqués : déclencheur Téléchargement en échec, puis un message avec la raison ; ou une scène sur la fonctionnalité Téléchargements en erreur au-dessus de 0.

  • Rattrapage hebdomadaire : chaque dimanche soir, Chercher épisodes, films, albums ou sous-titres manquants.

  • Indexeur en panne : déclencheur Indexeur Prowlarr en échec, puis une notification « Indexeur {{indexer}} en pause jusqu'à {{until}} ».

  • Sous-titres en retard : déclencheur Bazarr : sous-titres manquants au-delà du seuil, puis Chercher épisodes, films, albums ou sous-titres manquants sur l'appareil Bazarr.

Dépannage​

  • « ne répond pas » : vérifiez l'adresse et le port depuis la machine de Gladys (http://<adresse>:8989 pour Sonarr, :7878 pour Radarr, :8686 pour Lidarr). Gladys fait tourner l'intégration dans un conteneur : localhost est le conteneur lui-même, utilisez l'adresse IP de la machine.

  • « clé d'API refusée » : recopiez la clé depuis Settings → General → Security. Une nouvelle clé dans Sonarr, Radarr ou Lidarr doit être reportée ici.

  • « cette adresse est une autre application » : une adresse de Radarr dans une section Sonarr, un Sonarr dans une section Lidarr… (avec la clé de cette autre application ; avec la bonne clé, une mauvaise adresse répond « clé d'API refusée »).

  • « aucune API Sonarr, Radarr, Lidarr, Prowlarr ou Bazarr à cette adresse » ou « l'adresse redirige » : une instance derrière un proxy inverse demande sa base d'URL (https://example.org/sonarr), et une page de connexion du proxy bloque l'API : utilisez l'adresse locale.

  • « certificat refusé » : le HTTPS avec un certificat auto-signé n'est pas pris en charge ; utilisez l'adresse en http:// de votre réseau.

  • Pas d'affiche : l'application ne l'a pas encore téléchargée (MediaCover) ; elle arrive au prochain rafraîchissement de la série, du film ou de l'artiste. Un artiste sans affiche sur le serveur de métadonnées de Lidarr laisse ses albums sans image.

  • Bazarr « clé d'API refusée » : la clé est dans Bazarr, Settings → General → Security. Bazarr répond à toute autre adresse par sa page web : une adresse de Sonarr dans la section Bazarr donne « cette adresse est une autre application ».

  • Bazarr « Aucune instance n'a accepté la commande » : Sonarr et Radarr ne sont pas activés dans Bazarr (Settings → Sonarr / Radarr), il n'a rien à chercher.

Limites​

  • Pas de webhook : le bac à sable de Gladys n'a pas de port entrant, les imports sont donc lus dans l'historique à chaque rafraîchissement, pas poussés à l'instant.
  • Le nombre de Téléchargements en erreur lit les 100 premiers éléments de la file.
  • Le widget montre 12 sorties au plus, les premières dans le temps.
  • Pas de calendrier dans la vue calendrier de Gladys : une intégration est soit un appareil, soit un fournisseur de calendrier, et les appareils, déclencheurs et actions comptent davantage ici. Le widget joue le rôle du calendrier.
  • Lidarr ne garde les pochettes d'album qu'en taille réelle (souvent plus que les 300 Ko permis pour une image de widget) : les cartes montrent l'affiche de l'artiste.
  • Readarr et les clients de téléchargement ne sont pas couverts. Un Prowlarr et un Bazarr au plus.
  • Le seuil de Bazarr compte ensemble épisodes et films.
  • « Indexeur Prowlarr rétabli » veut dire que la pause est finie, pas que le site marche : un indexeur toujours en panne repart en pause au prochain échec (en échec, rétabli, en échec… avec des pauses de plus en plus longues).
  • Sans lien avec les projets Sonarr, Radarr, Lidarr, Prowlarr ou Bazarr.

Paramètres de configuration​

Voici les paramètres demandés par Sonarr, Radarr, Lidarr & co dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
SonarrsectionNonAdresse et clé d'API de votre Sonarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Sonarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:8989/sonarr).
Clé d'APIsecretNonSonarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Sonarr » suivi de l'adresse.
Deuxième Sonarr (facultatif)sectionNonLes mêmes champs, pour un autre Sonarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:8989/sonarr).
Clé d'APIsecretNonSonarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Sonarr » suivi de l'adresse.
RadarrsectionNonAdresse et clé d'API de votre Radarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Radarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:7878/radarr).
Clé d'APIsecretNonRadarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Radarr » suivi de l'adresse.
Deuxième Radarr (facultatif)sectionNonLes mêmes champs, pour un autre Radarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:7878/radarr).
Clé d'APIsecretNonRadarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Radarr » suivi de l'adresse.
LidarrsectionNonAdresse et clé d'API de votre Lidarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Lidarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:8686/lidarr).
Clé d'APIsecretNonLidarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Lidarr » suivi de l'adresse.
Deuxième Lidarr (facultatif)sectionNonLes mêmes champs, pour un autre Lidarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:8686/lidarr).
Clé d'APIsecretNonLidarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Lidarr » suivi de l'adresse.
Prowlarr (indexeurs)sectionNonFacultatif : le gestionnaire d'indexeurs de Sonarr, Radarr et Lidarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:9696/prowlarr).
Clé d'APIsecretNonProwlarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Prowlarr » suivi de l'adresse.
Bazarr (sous-titres)sectionNonFacultatif : les sous-titres de vos séries Sonarr et films Radarr.
AdressestringNonAdresse IP ou nom avec le port, et la base d'URL s'il y en a une (ex. http://192.168.1.2:6767/bazarr).
Clé d'APIsecretNonBazarr : Settings → General → Security → API Key.
NomstringNonNom de l'appareil dans Gladys. Vide : « Bazarr » suivi de l'adresse.
Seuil de sous-titres manquantsnumberNonLe déclencheur « Sous-titres manquants » part quand les épisodes et films sans sous-titres atteignent ce nombre.
OptionssectionNon
Intervalle de rafraîchissementselectNonFréquence de lecture des instances : file, calendrier, historique, santé.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités à l'ajout d'un appareil, et phrase de l'action de résumé.

Comment installer Sonarr, Radarr, Lidarr & co dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Sonarr, Radarr, Lidarr & co apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-arr:1.2.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-arr.

Sonarr, Radarr, Lidarr & co nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Sonarr, Radarr, Lidarr & co est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂