Intégration domotique TVmaze, gratuite et open source

Les prochains épisodes de vos séries dans le calendrier, les tableaux et les scènes.
Les prochains épisodes de vos séries dans Gladys, d'après TVmaze, un guide TV gratuit : un calendrier par utilisateur, un widget de tableau de bord et des déclencheurs de scène. Pas de compte, pas de clé d'API.
Cette intégration n'est pas affiliée à TVmaze. Elle a été testée contre la vraie API de TVmaze et la doublure de test de Gladys, pas encore sur une vraie instance Gladys : vos retours sont les bienvenus sur le forum ou sur GitHub.
Ce que vous obtenez
- Un calendrier « Séries TV » par utilisateur, dans le calendrier de Gladys : chaque épisode des séries que vous suivez, de deux semaines en arrière à un an en avant, avec sa saison et son numéro (S02E10), son titre, sa chaîne ou sa plateforme (FOX, Apple TV, Netflix…) comme lieu, et son résumé. Un épisode avec une heure de diffusion dure sa durée ; un épisode publié sans heure (en streaming, le plus souvent) occupe toute la journée.
- Un widget de tableau de bord, « Prochains épisodes » : les épisodes à venir, puis où en est chaque série (prochain épisode dans 3 jours, terminée, en cours sans date).
- Deux déclencheurs de scène : un épisode d'une série suivie passe aujourd'hui (le matin ou à l'heure de diffusion), et un nouvel épisode est annoncé pour une série qui n'en avait plus.
- Une action de scène, « Lire le prochain épisode » : le prochain épisode d'une série, les jours restants et le statut de la série.
La vue calendrier, le calendrier du tableau de bord et le déclencheur intégré « un événement du calendrier arrive » de Gladys fonctionnent aussi avec ces calendriers une fois partagés.
Configuration
Chaque utilisateur active l'intégration sur sa page, dans « Mes calendriers », et liste les séries qu'il suit dans Séries suivies, séparées par des virgules :
- un titre :
Severance,The Simpsons. Le meilleur résultat de TVmaze est retenu ; - un identifiant TVmaze :
#526(ou526) ; - une adresse TVmaze :
https://www.tvmaze.com/shows/526/the-office.
La description de votre calendrier dit quelle série chaque titre a trouvée (année, chaîne, identifiant), les titres inconnus de TVmaze, et les autres séries du même titre : « The Office » trouve la série américaine de 2005 (#526), la britannique de 2001 est #1292. Pour en choisir une autre, écrivez son identifiant à la place du titre. 25 séries au plus par utilisateur.
Le calendrier est d'abord privé. Partagez-le (l'interrupteur dans « Mes calendriers ») pour le voir sur le tableau de bord et l'utiliser dans les scènes : comme tout calendrier de Gladys, seuls les calendriers partagés atteignent les scènes, et un calendrier partagé est visible de tout le foyer.
L'administrateur choisit la langue des dates et des statuts transmis aux scènes. Le nom et la description des calendriers suivent la langue de chaque utilisateur.
Actions
Sur la page de l'intégration, pour l'administrateur :
- Vérifier : relit TVmaze maintenant pour tous les utilisateurs, et dit combien de séries et d'épisodes à venir ont été lus.
- Chercher une série : saisissez un titre, obtenez les meilleurs résultats de TVmaze avec leur année, leur chaîne et leur identifiant, à recopier dans une liste.
Scènes
Déclencheur « Épisode aujourd'hui » : une série suivie (sur un calendrier partagé) diffuse un épisode aujourd'hui. Le filtre Quand choisit le moment : le matin (9 h), ou à l'heure de diffusion (9 h aussi pour un épisode publié sans heure). Le filtre Série prend le titre exact tel qu'il apparaît dans le calendrier ; vide, toutes les séries. Variables : série, titre de l'épisode, code (S02E10), saison, numéro de l'épisode, chaîne, date, heure de diffusion, et les utilisateurs qui suivent la série.
Déclencheur « Nouvel épisode annoncé » : une série suivie qui n'avait pas de prochain épisode en reçoit un : nouvelle saison datée, retour de pause. Mêmes variables, plus les jours restants.
Action « Lire le prochain épisode » : le prochain épisode d'une série (son titre ou son début ;
vide : le plus proche de toutes), avec found (1 ou 0), épisode, code, date, days_left (-1 sans
date), chaîne, statut de la série et dernier épisode diffusé.
Exemples :
- Prévenir le foyer le jour de la diffusion : déclencheur « Épisode aujourd'hui », quand « Le matin », puis l'action Gladys « Envoyer un message » aux utilisateurs choisis, son texte construit avec les variables Série, Code et Chaîne prises dans la liste. Rien n'est envoyé tant que vous ne créez pas une telle scène.
- Baisser la lumière à l'heure de diffusion : déclencheur « Épisode aujourd'hui », quand « À l'heure de diffusion », série « The Simpsons », puis une action d'éclairage.
- Rappel de la semaine : une scène planifiée le dimanche soir, l'action « Lire le prochain épisode », puis un message avec ses sorties Série et Date.
Tableau de bord
Ajoutez le widget Prochains épisodes à un tableau de bord. Réglages : les séries à afficher (titres exacts ; vide, toutes les séries partagées), la période (7, 14 ou 31 jours) et l'affichage ou non de l'état de chaque série.
Limites
- Données : le guide de TVmaze. Les heures sont celles de la chaîne d'origine, converties dans le fuseau de Gladys : une série américaine diffusée à 20 h à New York apparaît à 2 h à Paris. Les diffusions locales (une chaîne française qui passe une série américaine) ne sont pas couvertes.
- Rafraîchissement : toutes les 6 heures, et quand un utilisateur modifie sa liste. TVmaze accepte 20 appels toutes les 10 secondes : l'intégration espace ses appels et lit chaque série une seule fois, quel que soit le nombre d'utilisateurs qui la suivent.
- Un épisode sans date de diffusion (à venir) n'entre dans le calendrier qu'une fois daté par TVmaze.
- 500 épisodes au plus par calendrier (bien au-delà d'un an de séries hebdomadaires).
Dépannage
- Le calendrier reste vide : lisez sa description (page Calendrier de Gladys). « Introuvable sur TVmaze » veut dire que le titre n'a rien trouvé : cherchez-le avec l'action « Chercher une série » et utilisez son identifiant.
- Ce n'est pas la bonne série : écrivez son identifiant (
#1292) à la place du titre. - Aucune scène ne se déclenche : le calendrier doit être partagé, et le filtre de série doit être le titre exact.
- « TVmaze injoignable » : l'intégration garde les épisodes déjà connus et réessaie, après une
minute puis de moins en moins souvent. Journaux : page de l'intégration, onglet Journaux
(
LOG_LEVEL=debugpour plus de détail).
Crédits
Les données des séries et des épisodes, résumés compris, viennent de TVmaze sous licence CC BY-SA. Chaque description de calendrier et d'événement cite TVmaze.
Paramètres de configuration
Voici les paramètres demandés par TVmaze dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Chaque utilisateur active l'intégration plus bas, dans « Mes calendriers », et liste les séries qu'il suit. Leurs épisodes remplissent un calendrier « Séries TV ». Partagez-le avec le foyer pour le voir sur le tableau de bord et l'utiliser dans les scènes. Données : TVmaze, gratuit, sans compte. |
| Langue des textes des scènes | select | Non | Dates et statuts transmis aux scènes. Les calendriers suivent la langue de chaque utilisateur. |
Comment installer TVmaze dans Gladys
- Dans Gladys, ouvrez Intégrations : TVmaze 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-tvmaze: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-tvmaze.
TVmaze nécessite Gladys >=5.2.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
TVmaze 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