Aller au contenu principal

Intégration Plex pour Gladys Assistant

Intégration Plex pour Gladys Assistant

Contrôlez vos lecteurs Plex : lecture, en cours, activité et bibliothèques.

Voir sur GitHubToutes les intégrations externes

Connectez votre serveur Plex à Gladys Assistant : contrôlez vos lecteurs Plex depuis Gladys et utilisez ce qui est en cours de lecture dans vos automatisations (baisser les lumières quand un film démarre, les rallumer au générique de fin...).

Ce que vous obtenez​

Un appareil « serveur » avec des capteurs de supervision :

  • Flux actifs — le nombre de lectures en cours ;
  • Sessions en transcodage — combien d'entre elles sont transcodées ;
  • Bande passante de streaming — la bande passante totale, en kbps ;
  • En cours de lecture — un résumé « qui regarde quoi » sur une ligne ;
  • Un compteur d'éléments par bibliothèque (désactivable) : films, séries (plus un compteur d'épisodes), artistes (plus un compteur de pistes)...

Un appareil par lecteur Plex (application TV, mobile, Chromecast... tout lecteur que votre serveur sait contrôler) :

  • Commandes de lecture : Lecture, Pause, Stop, Précédent, Suivant, Retour, Avance ;
  • Volume (0–100) et Sourdine ;
  • État de lecture (en lecture ou non) — compatible avec le widget Musique du tableau de bord de Gladys ;
  • En cours de lecture — le titre formaté du média (Série S01E02 - Épisode, Artiste - Titre, Film (année)) ;
  • Temps restant, en minutes ;
  • Dans l'intro et Dans le générique — des capteurs binaires actifs quand la lecture se trouve dans l'intro ou le générique de fin de l'épisode/du film (grâce aux marqueurs détectés par votre serveur Plex). Des déclencheurs parfaits pour vos scènes.

Les états de lecture se rafraîchissent toutes les quelques secondes (configurable), et l'intégration écoute aussi le flux de notifications temps réel du serveur : une lecture, une pause ou un arrêt est reflété dans Gladys en moins d'une seconde.

Configuration​

  1. Trouvez l'URL de votre serveur Plex, généralement http://<ip-du-serveur>:32400. Préférez l'adresse locale quand Gladys et Plex sont sur le même réseau.
  2. Trouvez votre jeton Plex (X-Plex-Token) : ouvrez l'application web Plex, lancez n'importe quel média, cliquez sur Obtenir des informations → Afficher XML, et copiez la valeur X-Plex-Token à la fin de l'URL. L'article officiel en lien dans l'écran de configuration détaille la démarche.
  3. Renseignez les deux champs dans l'onglet Configuration de l'intégration et enregistrez.
  4. Utilisez le bouton Tester la connexion Plex : il affiche le nom du serveur, sa version et le nombre de bibliothèques et de lecteurs trouvés.
  5. Ouvrez l'onglet Découverte : l'appareil serveur et vos lecteurs n'y attendent que vous.

Si votre serveur ne répond qu'en https avec un certificat auto-signé, utilisez de préférence l'adresse locale en http, ou activez Accepter un certificat auto-signé.

Options​

  • Rafraîchissement de la lecture — fréquence d'interrogation des sessions actives (10 s par défaut). Les notifications temps réel accélèrent le cas courant ; ce réglage est le rythme de secours.
  • Rafraîchissement des bibliothèques — fréquence de mise à jour des compteurs de bibliothèques (5 min par défaut).
  • Capteurs de bibliothèques — désactivez-le si vous ne voulez pas d'un compteur par bibliothèque sur l'appareil serveur.

Découverte des lecteurs​

Les lecteurs apparaissent automatiquement :

  • les lecteurs enregistrés auprès du serveur (la liste /clients) sont trouvés au démarrage et via le bouton Rechercher les lecteurs Plex ;
  • tout lecteur qui démarre une lecture est découvert à la volée et publié dans l'onglet Découverte, même s'il n'est pas contrôlable à distance.

Quels lecteurs sont pilotables ?​

Voir un lecteur et le piloter sont deux choses différentes : les capteurs (titre en cours, état, temps restant) fonctionnent pour tous les lecteurs, mais les boutons n'agissent que sur ceux qui acceptent le contrôle à distance.

  • ✅ Les applications TV / box / console (Android TV, Apple TV, Roku…) s'annoncent comme lecteurs par défaut : tout fonctionne.
  • ⚠️ Les applications mobiles, Plexamp et Plex Web ne le font généralement pas. Activez « S'annoncer comme lecteur » dans leurs réglages (souvent dans « Contrôle à distance ») — sans ce réglage, l'appli n'écoute aucune commande et aucun logiciel ne peut la piloter, Gladys comme l'application Plex elle-même.

L'intégration tente deux chemins avant d'abandonner : via le serveur (pour les lecteurs qu'il a découverts), puis directement vers le lecteur sur son adresse locale (port 32500) — le chemin qu'utilise Plex pour « caster ». Le bouton Stop dispose en plus d'un filet de sécurité : il coupe la lecture côté serveur, ce qui marche avec n'importe quel lecteur.

Idées d'automatisations​

  • Quand Dans le générique s'active dans le salon → rallumer les lumières ;
  • Quand État de lecture s'active après 22 h → tamiser les lumières à 20 % ;
  • Quand Flux actifs dépasse 3 → envoyer une notification (bande passante !) ;
  • Un bouton sur le tableau de bord pour mettre en Pause tous les lecteurs à l'heure du dîner.

Dépannage​

L'intégration journalise tout ce qu'elle fait : consultez les logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte) avec LOG_LEVEL=debug pour le détail complet.

  • « Plex authentication failed » — le jeton est invalide ou expiré. Récupérez un X-Plex-Token à jour et mettez la configuration à jour.
  • « Plex server unreachable » — vérifiez l'URL (schéma, IP, port 32400) et que Gladys peut joindre le réseau du serveur.
  • Un lecteur ne réagit pas aux commandes — les commandes transitent par le serveur, qui doit pouvoir joindre le lecteur. Si rien ne se passe, activez « S'annoncer comme lecteur » dans l'application Plex concernée (réglage absent de certaines applications), puis relancez Rechercher les lecteurs Plex. Quand le serveur refuse une commande, Gladys affiche une erreur explicite — sauf pour Stop, qui interrompt alors la lecture côté serveur (fin de session), ce qui fonctionne avec n'importe quel lecteur.
  • Les capteurs intro/générique ne s'activent jamais — la détection des intros/génériques doit être activée sur votre serveur Plex (Réglages → Bibliothèque) et les marqueurs n'existent que pour les éléments déjà analysés.

Paramètres de configuration​

Voici les paramètres demandés par Plex dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Connexion à votre serveur PlexsectionNonIndiquez l'adresse locale de votre serveur Plex (par exemple http://192.168.1.20:32400) et un jeton d'authentification Plex (X-Plex-Token). L'article en lien explique comment trouver votre jeton depuis l'application web Plex.
URL du serveur PlexstringOuiURL de base du serveur Plex, port inclus (32400 par défaut).
Jeton Plex (X-Plex-Token)secretOui
Rafraîchissement de la lecture (s)numberNonFréquence de rafraîchissement des lectures en cours, en secondes. Les notifications temps réel du serveur accélèrent la mise à jour quand une lecture démarre, se met en pause ou s'arrête.
Rafraîchissement des bibliothèques (s)numberNonFréquence de rafraîchissement des statistiques des bibliothèques (nombre d'éléments), en secondes.
Capteurs de bibliothèquesbooleanNonAjoute un capteur de compte d'éléments par bibliothèque Plex sur l'appareil serveur (plus les épisodes pour les séries et les pistes pour la musique).
Accepter un certificat auto-signébooleanNonUniquement pour les URL https : accepte le certificat auto-signé du serveur Plex. Laissez désactivé pour les URL http.

Comment installer Plex dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Plex 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-plex:1.0.3), 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-plex.

Plex nécessite Gladys >=4.86.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​

Plex 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 🙂
Dernière mise à jour le