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

Sonarr, Radarr et Lidarr : sorties de la semaine, file, manquants, alertes de santé, recherches.

• Publiée par guim31
• Appareils
• Version 1.1.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

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.

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 ligne	1 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 libre	Espace 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
Version	Version de Sonarr, Radarr ou Lidarr

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éclencheur	Quand	Filtres	Variables
Épisode, film ou album téléchargé	Sonarr, Radarr ou Lidarr a importé un téléchargement terminé dans la bibliothèque	instance, application	nom de l'instance, titre, titre avec épisode, année ou artiste, qualité
Téléchargement en échec	Un téléchargement a été marqué en échec	instance, application	nom 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, niveau	nom 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.

Actions

Action	Ce qu'elle fait	Sorties
Chercher les épisodes, films ou albums manquants	Lance la recherche de tous les épisodes, films ou albums surveillés manquants, sur une instance ou toutes	instances ayant lancé la recherche
Rafraîchir la bibliothèque Sonarr, Radarr ou Lidarr	Demande 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é Sonarr/Radarr/Lidarr	Construit 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.

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é Sonarr/Radarr/Lidarr, 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 les épisodes, films ou albums manquants.

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 ou Lidarr à 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.

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, Prowlarr et les clients de téléchargement ne sont pas couverts.
• Sans lien avec les projets Sonarr, Radarr ou Lidarr.

Paramètres de configuration

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

Paramètre	Type	Obligatoire	Description
Sonarr	section	Non	Adresse et clé d'API de votre Sonarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Sonarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Sonarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Sonarr » suivi de l'adresse.
Deuxième Sonarr (facultatif)	section	Non	Les mêmes champs, pour un autre Sonarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Sonarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Sonarr » suivi de l'adresse.
Radarr	section	Non	Adresse et clé d'API de votre Radarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Radarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Radarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Radarr » suivi de l'adresse.
Deuxième Radarr (facultatif)	section	Non	Les mêmes champs, pour un autre Radarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Radarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Radarr » suivi de l'adresse.
Lidarr	section	Non	Adresse et clé d'API de votre Lidarr (Settings → General → Security). Laissez vide si vous n'utilisez pas Lidarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Lidarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Lidarr » suivi de l'adresse.
Deuxième Lidarr (facultatif)	section	Non	Les mêmes champs, pour un autre Lidarr.
Adresse	string	Non	Adresse 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'API	secret	Non	Lidarr : Settings → General → Security → API Key.
Nom	string	Non	Nom de l'appareil dans Gladys. Vide : « Lidarr » suivi de l'adresse.
Options	section	Non
Intervalle de rafraîchissement	select	Non	Fréquence de lecture des instances : file, calendrier, historique, santé.
Langue des noms de fonctionnalités	select	Non	Noms donnés aux fonctionnalités à l'ajout d'un appareil, et phrase de l'action de résumé.

Comment installer Sonarr, Radarr & Lidarr dans Gladys

1. Dans Gladys, ouvrez Intégrations : Sonarr, Radarr & Lidarr 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.1.0), 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 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 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.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

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 🙂