Intégration domotique Programme Télé, gratuite et open source

Programme TV (TNT) : ce qui passe maintenant, ensuite et ce soir sur vos chaînes préférées.
Cette intégration affiche le programme TV des chaînes de la TNT française dans Gladys : ce qui passe en ce moment, le programme à suivre et celui de ce soir.
Ce que vous obtenez
Un appareil par chaîne choisie (par exemple « Programme TV TF1 »), avec 3 capteurs texte :
- En cours — le programme diffusé maintenant, avec ses horaires
(
JT 20h (20:00 - 20:45)) ; - À suivre — le programme suivant (
20:45 · Petits plats en équilibre) ; - Ce soir — le programme diffusé à 21h10, heure de Paris
(
21:10 · Koh-Lanta).
Les horaires sont toujours affichés à l'heure de Paris.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Cochez les chaînes à suivre (30 chaînes TNT disponibles).
- Enregistrez : les appareils apparaissent dans l'onglet Découverte, prêts à être ajoutés.
Les capteurs sont mis à jour toutes les minutes. Le programme complet (8 jours) est téléchargé au plus toutes les 6 heures.
Widget du tableau de bord
Ajoutez le widget Programme TV à un tableau de bord (Gladys 5.1 ou plus). Réglages :
- Afficher : En ce moment (avec le temps restant) ou Ce soir (21h10) ;
- Chaînes : 8 chaînes maximum ; laissez vide pour reprendre les chaînes de la configuration de l'intégration.
Touchez une ligne pour lire le résumé du programme. Le widget se met à jour tout seul quand un programme se termine.
Scènes
Déclencheur « Un programme TV commence » — lance une scène au début d'un programme. Filtres (vides = tout) :
- Chaînes : une ou plusieurs chaînes ;
- Titre exact : par exemple
Koh-Lanta(titre exact, majuscules comprises ; « contient » n'est pas possible).
Variables utilisables dans les actions suivantes : chaîne, titre, sous-titre, catégorie, heure de début, heure de fin, durée (min). Exemple : « Quand Koh-Lanta commence sur TF1, allumer la TV et m'envoyer un message ».
Le déclencheur fonctionne pour les 30 chaînes, même celles qui ne sont pas cochées dans la configuration. Un programme est détecté dans les secondes qui suivent son début. Après une coupure, les programmes commencés dans les 5 dernières minutes déclenchent encore la scène ; les plus anciens non.
Action « Lire le programme TV d'une chaîne » — renvoie à la scène le programme en cours, à suivre et de ce soir (texte complet, titre seul, heure). Exemple : envoyer chaque soir à 20h « Ce soir sur France 2 : … ».
Actions
- Tester le programme TV — télécharge le programme tout de suite et affiche ce qui passe sur la première chaîne choisie. Si le téléchargement échoue, il le dit, et précise si l'ancien programme reste utilisé.
Source des données
Le programme vient du flux XMLTV gratuit de xmltvfr.fr (fichier TNT). Pas de compte, pas de clé d'API. L'intégration a donc besoin d'un accès à Internet.
Dépannage
- « Aucun programme » : la source n'a pas de données pour cette chaîne à ce moment-là.
- Statut « déconnecté » : le message dit ce qui ne va pas.
- Impossible de télécharger le programme TV : aucun programme n'a encore pu être téléchargé ; un nouvel essai est fait toutes les 2 minutes.
- Le programme TV est périmé : la source ne répond plus depuis longtemps et l'ancien programme en mémoire n'a plus rien à venir.
- Gladys a refusé les appareils des chaînes ou Impossible d'envoyer les programmes à Gladys : le programme est là, c'est Gladys qui a refusé ; l'intégration réessaie toute seule chaque minute.
- Si un téléchargement échoue alors qu'un ancien programme est en mémoire, celui-ci continue d'être utilisé (il couvre plusieurs jours) ; un nouvel essai est fait 15 minutes plus tard. Le bouton Tester le programme TV le dit aussi.
- Consultez les logs de l'intégration depuis l'interface Gladys (ou
docker logssur l'hôte) avecLOG_LEVEL=debugpour le détail complet.
Paramètres de configuration
Voici les paramètres demandés par Programme Télé dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Choisissez les chaînes à suivre : chacune devient un appareil avec 3 capteurs (en cours, à suivre, ce soir). Le programme vient du flux XMLTV gratuit de xmltvfr.fr. Pas de compte, pas de clé d'API. |
| Chaînes | multi_select | Oui | Un appareil Gladys est créé par chaîne cochée. |
Comment installer Programme Télé dans Gladys
- Dans Gladys, ouvrez Intégrations : Programme Télé 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/prohand/gladys-programmetele:2.4.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/prohand/gladys-programmetele.
Programme Télé 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
Programme Télé 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 prohand, 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