Intégration domotique Sonarr & Radarr, gratuite et open source
Sonarr et Radarr : sorties de la semaine, file, manquants, alertes de santé, recherches.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Amenez votre Sonarr (séries) et votre Radarr (films) dans Gladys, sur votre réseau local : les épisodes et films 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 ou un film est téléchargé.
L'intégration a été testée contre de vrais Sonarr 4 et Radarr 6 (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, et/ou Radarr v3 ou plus récent, joignables depuis Gladys (même réseau). Jusqu'à deux de chaque.
- La clé d'API de chaque instance : dans Sonarr ou Radarr, Settings → General → Security → API Key.
Mise en route
- Installez l'intégration depuis le catalogue de Gladys.
- 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 (port7878par défaut). 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…) ou Radarr ? Remplissez la section Deuxième Sonarr ou Deuxième Radarr. - 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é.
- 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 et de « films » sur un Radarr.
| 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 Sonarr ou Radarr (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 | Épisodes ou films surveillés sans fichier (Wanted → Missing) |
| Épisodes des 7 prochains jours / Films des 7 prochains jours | Épisodes diffusés, ou films qui sortent (cinéma, numérique, disque), 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 ou Radarr |
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 et films qui sortent d'aujourd'hui aux 6 jours suivants, avec leur affiche, 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 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 et Radarr 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 ou film téléchargé | Sonarr ou Radarr a importé un téléchargement terminé dans la bibliothèque | instance, application | nom de l'instance, titre, titre avec épisode ou année, 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 ou année, 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.
Actions
| Action | Ce qu'elle fait | Sorties |
|---|---|---|
| Chercher les épisodes ou films manquants | Lance la recherche de tous les épisodes ou films surveillés manquants, sur une instance ou toutes | instances ayant lancé la recherche |
| Rafraîchir la bibliothèque Sonarr ou Radarr | Demande le rafraîchissement des informations et fichiers de chaque série ou film (exécuté en arrière-plan par Sonarr ou Radarr) | instances rafraîchies |
| Lire le résumé Sonarr/Radarr | 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 ou film téléchargé avec l'application Radarr, puis une notification qui reprend la variable Titre avec épisode (S01E02) ou année : « Avatar (2009) est prêt ».
- Résumé du matin : chaque jour à 8 h, Lire le résumé Sonarr/Radarr, 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 ou films manquants.
Dépannage
- « ne répond pas » : vérifiez l'adresse et le port depuis la machine de
Gladys (
http://<adresse>:8989pour Sonarr,:7878pour Radarr). Gladys fait tourner l'intégration dans un conteneur :localhostest 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 ou Radarr doit être reportée ici.
- « cette adresse est l'autre application » : une adresse de Radarr dans une section Sonarr, ou l'inverse (avec la clé de cette autre application ; avec la bonne clé, une mauvaise adresse répond « clé d'API refusée »).
- « aucune API Sonarr ou Radarr à 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 : Sonarr ou Radarr ne l'a pas encore téléchargée (MediaCover) ; elle arrive au prochain rafraîchissement de la série ou du film.
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, Readarr, Prowlarr et les clients de téléchargement ne sont pas couverts.
- Sans lien avec les projets Sonarr ou Radarr.
Paramètres de configuration
Voici les paramètres demandés par Sonarr & Radarr 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. |
| 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 dans Gladys
- Dans Gladys, ouvrez Intégrations : Sonarr & Radarr apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-arr:1.0.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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-arr.
Sonarr & Radarr 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 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