Intégration domotique Tautulli, gratuite et open source
Votre serveur Plex via Tautulli : flux, transcodage, bande passante, qui regarde quoi.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez votre serveur Plex dans Gladys via Tautulli : flux en cours, transcodage, bande passante, qui regarde quoi, et des scènes qui démarrent quand une lecture démarre, se met en pause, reprend ou s'arrête.
Intégration non officielle, sans lien avec Tautulli ni Plex. Elle n'a jamais été testée sur un vrai Tautulli : elle a été écrite d'après la référence de l'API de Tautulli et la bibliothèque pytautulli. Vos retours sont les bienvenus.
L'intégration ne fait que lire : elle n'arrête jamais un flux et ne change rien dans Tautulli ni dans Plex.
Prérequis
- Tautulli v2 joignable depuis Gladys (même réseau), avec son API activée.
- Sa clé d'API : dans Tautulli, Settings → Web Interface → API, cochez Enable API, puis copiez l'API key (32 caractères).
Configuration
- Installez l'intégration depuis le store.
- Adresse de Tautulli :
192.168.1.10:8181(une adresse seule est lue enhttp://sur le port 8181, celui de Tautulli). Avechttp://ouhttps://et sans port, le port 80 ou 443 est utilisé (Tautulli derrière un proxy inverse ; un chemin comme/tautulliest gardé). Ne collez pas?apikey=…: la clé a son propre champ. - Clé d'API : collez-la. Elle est gardée par Gladys dans sa base (masquée dans l'interface, non chiffrée), jamais réaffichée, et envoyée seulement à Tautulli.
- Utilisateurs à suivre (facultatif) : noms d'utilisateur Plex, noms affichés ou identifiants, séparés par des virgules (10 au plus). Chacun devient un appareil.
- Enregistrez, puis appuyez sur Tester la connexion.
- Dans l'onglet Découverte, créez les appareils voulus.
Appareils
Plex (Tautulli), un par intégration :
| Fonction | Type | Signification |
|---|---|---|
| Streams | compteur | flux en cours |
| Streams transcoding | compteur | flux que Plex transcode |
| Streams in direct play | compteur | flux lus tels quels |
| Streams in direct stream | compteur | flux remuxés (conteneur changé seulement) |
| Bandwidth, LAN, WAN | débit, kbit/s | tel que Tautulli le calcule |
| Plex reachable | binaire (lecture seule) | 1 : Tautulli a lu l'activité de Plex ; 0 : il n'a pas pu |
Plex : <utilisateur>, un par utilisateur suivi : Streams (compteur) et Now playing (texte : le titre, « (+1) » s'il y en a plusieurs, « — » quand rien ne joue).
Déclencheur de scène
Lecture Plex démarrée, en pause, reprise ou arrêtée, avec deux filtres
facultatifs : l'événement, et un utilisateur suivi. Les variables event,
user_name, title, media_type et player sont utilisables dans les
actions (un message, par exemple).
L'activité est lue au rythme choisi (30 s par défaut) : une scène démarre jusqu'à un intervalle après l'événement, et une pause ou un arrêt plus court que l'intervalle peut passer inaperçu. Rien ne se déclenche pour les flux déjà en cours au démarrage de l'intégration ou au retour de Tautulli après une panne.
Certificat (https seulement)
Par défaut une adresse https exige un certificat d'une autorité reconnue. Pour un certificat auto-signé :
- cochez Accepter le certificat auto-signé : le certificat vu à la première connexion est mémorisé ; la clé d'API part vers celui qui répond à cette première connexion. Un autre certificat ensuite est refusé tant que vous n'appuyez pas sur Faire confiance au nouveau certificat ;
- ou, plus sûr, saisissez son empreinte SHA-256 :
openssl s_client -connect 192.168.1.10:8181 </dev/null | openssl x509 -noout -fingerprint -sha256.
Sécurité et vie privée
- L'intégration envoie la clé dans l'URL de chaque requête
(
?apikey=) : la méthode acceptée par toutes les versions de Tautulli (l'en-têteX-Api-Keyn'existe que depuis Tautulli 2.18.0 ; son usage est prévu). L'intégration n'écrit jamais d'URL, la clé ni un message de Tautulli dans ses journaux, mais un proxy inverse devant Tautulli peut journaliser les URL, clé comprise : joignez Tautulli directement, ou coupez les journaux d'accès du proxy pour/api/v2. Enhttp://la clé traverse votre réseau en clair : gardez Tautulli sur votre réseau local, ou utilisez https. - La clé donne tout l'accès à l'API de Tautulli (qui sait aussi couper des
flux) : l'intégration n'utilise que
get_activityetget_users. - Les titres et noms d'utilisateurs vont dans Gladys (appareils, variables de scène) : seulement pour les utilisateurs suivis sur les appareils ; le déclencheur porte le nom de tout utilisateur.
Erreurs et limites
- Clé refusée (fausse ou régénérée) : Gladys s'arrête et ne réessaie jamais seul ; collez la clé actuelle et enregistrez, ou appuyez sur Tester la connexion.
- API désactivée : activez-la dans Tautulli ; Gladys réessaie (30 s à 10 min).
- HTTP 429 ou erreur serveur (5xx) : toutes les requêtes sont suspendues
(1 min à 6 h,
Retry-Afterrespecté), même après un redémarrage ; Tester la connexion lève la pause. - Tautulli injoignable : nouvel essai après 30 s, doublé jusqu'à 10 min, jamais plus tôt que l'intervalle choisi.
- Plex non lu (Plex arrêté ou injoignable depuis Tautulli) : « Plex reachable » passe à 0, les autres chiffres gardent leur dernière valeur.
- La liste des utilisateurs est lue toutes les 10 minutes (2 minutes après un échec) ; un utilisateur suivi qui lance une lecture est trouvé aussitôt.
- Un Tautulli par intégration ; 10 utilisateurs suivis au plus.
- Pas dans cette version : couper un flux, les bibliothèques, l'historique et les statistiques de Tautulli.
Paramètres de configuration
Voici les paramètres demandés par Tautulli dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Gladys lit l'activité de votre serveur Plex par l'API de Tautulli, avec sa clé d'API, et ne fait que lire : elle n'arrête jamais un flux. Le serveur devient un appareil Gladys (onglet Découverte) : flux en cours, transcodage, lecture directe, flux direct, bande passante (totale, LAN, WAN) et si Tautulli joint Plex. Jusqu'à 10 utilisateurs Plex peuvent être suivis, un appareil chacun (flux, titre en cours). Intégration non officielle, sans lien avec Tautulli ni Plex. |
| Adresse de Tautulli | string | Oui | L'adresse de Tautulli sur votre réseau. Une adresse seule (sans http://) est lue en http sur le port 8181, celui de Tautulli ; avec http:// ou https:// et sans port, le port 80 ou 443 (un proxy inverse, un chemin est gardé). En http la clé d'API traverse votre réseau en clair : préférez https si Tautulli est joint par un autre réseau. |
| Clé d'API | secret | Oui | Dans Tautulli : Settings, Web Interface, API (cochez « Enable API »). Gardée par Gladys dans sa base, jamais réaffichée, envoyée seulement à Tautulli, dans l'URL de chaque requête (la méthode acceptée par toutes les versions de Tautulli ; l'en-tête X-Api-Key n'existe que depuis la 2.18.0) ; jamais écrite dans un journal de Gladys, mais un proxy inverse devant Tautulli peut journaliser les URL. |
| Certificat (https seulement) | section | Non | En https, le certificat de Tautulli doit venir par défaut d'une autorité reconnue. Pour un certificat auto-signé : cochez la case ci-dessous (le certificat vu à la première connexion est mémorisé : la clé d'API part vers celui qui répond à cette première connexion), ou saisissez son empreinte SHA-256 (plus sûr : rien d'autre n'est jamais accepté, même la première fois). Un autre certificat ensuite est refusé avant l'envoi de la clé d'API. |
| Accepter le certificat auto-signé | boolean | Non | Activé : le certificat vu à la première connexion est accepté et mémorisé ; un autre ensuite est refusé tant que vous n'appuyez pas sur « Faire confiance au nouveau certificat ». |
| Empreinte du certificat (SHA-256, facultatif) | string | Non | Épingle ce certificat : Tautulli doit présenter exactement celui-ci. L'empreinte est affichée par votre navigateur (détails du certificat) ou par openssl (voir la documentation). |
| Utilisateurs et rafraîchissement | section | Non | Gladys lit l'activité au rythme ci-dessous (30 secondes par défaut). Un démarrage, une pause ou un arrêt plus court que cet intervalle peut échapper au déclencheur de scène. |
| Utilisateurs à suivre (facultatif) | string | Non | Noms d'utilisateur Plex, noms affichés ou identifiants, séparés par des virgules : un appareil chacun (10 au plus). Vide : aucun, seulement l'appareil du serveur. |
| Rafraîchissement | select | Oui |
Comment installer Tautulli dans Gladys
- Dans Gladys, ouvrez Intégrations : Tautulli 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/lm1lc3n7/gladys-tautulli:0.1.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). - 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/LM1LC3N7/gladys-tautulli.
Tautulli 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
Tautulli 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 LM1LC3N7, 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