Intégration domotique Philips TV, gratuite et open source
Téléviseurs Philips Android et Saphi : marche, volume, sources, applis, Ambilight, touches. Local.
Publiée par guim31
- Appareils
- Version 1.0.3
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos téléviseurs Philips depuis Gladys, sur votre réseau local : les allumer et les éteindre, régler le volume, changer de source, ouvrir une application, changer de chaîne, régler l'Ambilight (style, couleur fixe, marche ou arrêt), appuyer sur n'importe quelle touche de la télécommande, depuis le tableau de bord ou une scène. Et réagir à ce qui se passe à l'écran : « quand Netflix s'ouvre sur le téléviseur, baisser les lumières ».
Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été construite et testée sur les vraies réponses de téléviseurs Philips conservées par la bibliothèque libre ha-philipsjs (celle qu'utilise Home Assistant) et sur la documentation communautaire de l'API JointSpace, avec un téléviseur simulé, pas sur un vrai téléviseur Philips. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.
Ce qu'il faut
- Gladys Assistant 5.1.0 ou plus récent.
- Un téléviseur Philips doté de l'API JointSpace 6, sur le même réseau
local que Gladys, avec une adresse IP fixe (une réservation DHCP dans votre
box ou routeur) :
- un modèle Android TV ou Google TV (2016 et après) : appairé une fois avec Gladys, avec un code affiché sur le téléviseur ;
- ou un modèle Saphi (Linux) : sans appairage.
- Pour allumer le téléviseur depuis Gladys : sur le téléviseur, Allumer avec le Wi-Fi (WoWLAN) ou Allumer avec Chromecast activé (en général dans Paramètres → Réseau sans fil et réseaux → Filaire ou Wi-Fi). Sans cela, beaucoup de téléviseurs coupent leur réseau en veille.
Mise en route
-
Installez l'intégration depuis le catalogue de Gladys.
-
Allumez le téléviseur. Dans Configuration, cliquez sur Rechercher les téléviseurs : les téléviseurs qui répondent sur votre réseau sont placés dans les emplacements libres (téléviseur 1, 2, 3), avec leur adresse. Ou saisissez vous-même l'Adresse du téléviseur (par exemple
192.168.1.20). Donnez-lui si vous voulez un Nom, puis enregistrez. -
Un téléviseur Android s'appaire ensuite une fois :
- cliquez sur Afficher un code d'appairage sur le téléviseur (choisissez le téléviseur) : un code à 4 chiffres s'affiche à l'écran ;
- saisissez-le dans Confirmer le code d'appairage (même téléviseur), et lancez-la, vite : le téléviseur attend une trentaine de secondes.
Gladys apparaît sur le téléviseur sous le nom Gladys Assistant. L'intégration garde l'appairage : aucun code ne sera redemandé. Un téléviseur Saphi n'a pas besoin d'appairage.
-
Cliquez sur Tester la connexion : le message sous le bouton indique, pour chaque téléviseur, s'il répond, son modèle, s'il est allumé et appairé.
-
Ouvrez l'onglet Découverte : un appareil par téléviseur. Cliquez sur Ajouter, choisissez une pièce, enregistrez. Un téléviseur y apparaît dès qu'il a répondu une fois : allumez-le s'il n'apparaît pas. Rechercher dans cet onglet cherche aussi de nouveaux téléviseurs.
Les options en bas de page :
- Wake-on-LAN (activé par défaut) : un téléviseur dont le réseau s'endort en veille ne répond plus du tout. Gladys demande alors à son cœur d'envoyer un paquet Wake-on-LAN à l'adresse MAC donnée par le téléviseur, qui le réveille. L'intégration le déclare, comme l'indique l'écran d'installation.
- Intervalle de rafraîchissement : la fréquence de lecture des téléviseurs (10 s par défaut). Un téléviseur en veille n'est interrogé que sur son état et son Ambilight.
- Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités à l'ajout d'un appareil, et les textes des listes et des événements de scène.
L'appareil de chaque téléviseur
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| Marche / arrêt | Allumé ou en veille. L'allumage le demande au téléviseur, ou envoie un paquet Wake-on-LAN s'il ne répond plus du tout. |
| Volume | Le volume, en curseur, dans les bornes du téléviseur (0 à 60 sur la plupart des modèles). |
| Diminuer le volume | Un cran plus bas, comme la télécommande. |
| Augmenter le volume | Un cran plus haut. |
| Muet | Coupe ou rétablit le son. |
| Source | Téléviseurs Android : TV (le tuner) ou HDMI 1 à HDMI 4, et pour en changer. Autre est une application ; la choisir appuie sur Accueil. |
| Application | Téléviseurs Android : l'application au premier plan (le téléviseur le dit), et pour en ouvrir une autre. Accueil ou autre appuie sur Accueil. |
| Chaîne | Le numéro de la chaîne à l'écran, et pour passer à un autre numéro. |
| Chaîne précédente | Chaîne précédente. |
| Chaîne suivante | Chaîne suivante. |
| En cours | Ce qui est à l'écran, en texte : 5 · France 5, Netflix, HDMI 2, Source HDMI, ou Éteinte. |
| Ambilight | Ambilight allumé ou éteint. |
| Style Ambilight | Le style, issu des menus du téléviseur : Suivre la vidéo (Standard, Éclatant, Jeu…), Suivre l'audio (Lumina, Retro…), Lounge light (Lave en fusion…), ou Couleur fixe. |
| Couleur Ambilight | Une couleur fixe, avec le sélecteur de couleur de Gladys. |
| Ambilight + Hue | Les lampes Hue qui suivent l'Ambilight, allumées ou éteintes (téléviseurs Ambilight + Hue seulement). |
Le téléviseur dit ce qu'il sait faire : un téléviseur Saphi n'a ni Source ni Application, un téléviseur sans Ambilight aucune fonctionnalité Ambilight. Les listes (applications, styles Ambilight, chaînes) sont lues sur le téléviseur et gardées par l'intégration : elles sont là même quand il dort. Une commande qui a besoin de l'écran (une source, une application, une chaîne) allume d'abord le téléviseur et l'attend, jusqu'à 25 secondes.
Tableau de bord
Quatre widgets, à placer côte à côte ; chacun montre un téléviseur (le premier de la configuration si aucun n'est choisi dans ses réglages). Le cœur limite un widget à quatre boutons, d'où les quatre.
- Télécommande Philips : l'état du téléviseur, ce qui est à l'écran, le volume, et les boutons Allumer (ou Éteindre), Volume −, Volume + et Muet.
- Ambilight Philips : l'Ambilight et son style, un bouton pour l'allumer ou l'éteindre, et trois styles choisis dans les réglages du widget (dont une couleur fixe) ; le style en cours est coché.
- Touches Philips : quatre touches de la télécommande, choisies dans les réglages du widget : les flèches par défaut. Ajoutez-en un second avec OK, Retour, Accueil, Sources, ou Lecture / pause…
- Raccourcis Philips : jusqu'à quatre sources ou applications favorites,
saisies par leur nom dans les réglages (
HDMI 2,Netflix…) ; TV et HDMI 1 à HDMI 3 si rien n'est saisi. Un appui l'affiche, le téléviseur allumé d'abord. Un nom que le téléviseur ne connaît pas est signalé sous les boutons.
Scènes
Déclencheur
TV : application, chaîne ou source changée : ce qui est à l'écran a
changé, allumage compris. Filtres : le téléviseur, ce qui est désormais à
l'écran (application ou écran d'accueil, chaîne, source HDMI), son nom
exactement comme l'affiche le téléviseur (Netflix, YouTube), et qui l'a
changé (Gladys, ou le téléviseur et sa télécommande, une console en
HDMI-CEC…). Variables : le téléviseur, le type (app, channel, source),
le nom (de l'application, de la chaîne ou de la source), le numéro de chaîne,
et qui l'a changé.
Le téléviseur dit quelle application est au premier plan : passer d'une application à une autre déclenche la scène. Pour une source HDMI, le téléviseur ne dit pas laquelle : le nom est celui que Gladys a choisi, sinon Source HDMI.
Pas de déclencheur « téléviseur allumé » ou « téléviseur éteint » : la fonctionnalité Marche / arrêt déclenche déjà les scènes, comme tout appareil.
Actions
- Ouvrir une application sur le téléviseur : par son nom comme sur le
téléviseur (
Netflix,youtube: la casse, les accents et les espaces ne comptent pas). Sortie : l'application ouverte. - Choisir une source du téléviseur : TV ou HDMI 1 à HDMI 4. Sortie : la source choisie.
- Régler l'Ambilight : un style (Suivre la vidéo · Standard, Lounge
light · Lave en fusion…), une couleur fixe (saisie
#FF8800, la dernière si vide), ou éteint. Un style que le téléviseur n'a pas est refusé. Sortie : le style appliqué. - Envoyer une touche de télécommande : Accueil, Retour, flèches, OK, Sources, volume, chaînes, lecture, couleurs, chiffres, Ambilight…, une à dix fois. Sortie : les appuis envoyés.
Les deux premières demandent un téléviseur Android, et allument d'abord le téléviseur si besoin. Avec plusieurs téléviseurs, choisissez le téléviseur dans l'action. Les fonctionnalités Marche / arrêt, Volume, Chaîne et Ambilight sont dans l'action habituelle Contrôler un appareil.
Idées de scènes
- Soirée film : le vendredi à 21 h, Ouvrir une application sur le
téléviseur
Netflix, Régler l'Ambilight sur Suivre la vidéo · Immersif, baisser les lumières du salon. - Netflix ouvert : déclencheur TV : application, chaîne ou source
changée, désormais à l'écran Application, nom
Netflix: fermer les volets. - Bonne nuit : à 23 h, Régler l'Ambilight sur une couleur fixe
#FF6A00, puis éteindre le téléviseur (Marche / arrêt) quelques minutes plus tard. - Départ de la maison : dans la scène « tout le monde est parti », mettre la Marche / arrêt des téléviseurs sur arrêt.
Dépannage
- « Pas encore joint : allumez le téléviseur une fois » : le téléviseur n'a jamais répondu. Vérifiez son adresse et allumez-le.
- « Pas encore appairé » : un téléviseur Android a besoin de l'appairage : Afficher un code d'appairage sur le téléviseur, puis Confirmer le code d'appairage.
- « Appairage refusé par le téléviseur : appairez-le à nouveau » : l'appairage a été supprimé sur le téléviseur (une réinitialisation, un nouveau logiciel). Appairez-le de nouveau, de la même façon.
- « Code erroné » : saisissez à nouveau les 4 chiffres affichés. « Le code a expiré » : affichez-en un nouveau, et confirmez-le dans les 30 secondes.
- « Pas d'API de téléviseur Philips à cette adresse » : un autre appareil y répond.
- « Téléviseur antérieur à 2016 (JointSpace 1) » : ces modèles anciens ne sont pas pris en charge.
- Le téléviseur ne s'allume pas : activez Allumer avec le Wi-Fi (WoWLAN) ou Allumer avec Chromecast sur le téléviseur, et gardez Wake-on-LAN activé ; le paquet ne traverse ni routeur ni VLAN.
- Rechercher les téléviseurs ne trouve rien : le téléviseur doit être allumé, sur le même réseau ; saisissez plutôt son adresse.
- Une source HDMI ne change pas : les adresses HDMI sont celles des modèles 2019 et après ; sur les téléviseurs Android plus anciens, utilisez la touche Sources.
- Les logs de l'intégration (onglet Configuration) disent ce que répond chaque téléviseur ; aucune clé d'appairage n'y est jamais écrite.
Limites
- Développée sans le matériel : les comportements viennent de ha-philipsjs, de pylips et de leurs réponses réelles, pas d'un vrai téléviseur.
- Téléviseurs Philips dotés de l'API JointSpace 6 : modèles Android TV et Google TV depuis 2016, modèles Saphi. Les modèles antérieurs à 2016 (JointSpace 1) ne sont pas pris en charge.
- Sources et applications : téléviseurs Android seulement. Le téléviseur ne dit pas quelle entrée HDMI est à l'écran.
- Ambilight : les styles des menus du téléviseur et une couleur fixe ; les couleurs pixel par pixel et la luminosité de l'Ambilight ne sont pas pilotées.
- Chaînes : celles des listes de chaînes du téléviseur, lues une fois par jour.
- Tout reste sur votre réseau local : pas de cloud, pas de compte Philips. L'intégration ne parle qu'aux téléviseurs configurés, et demande au cœur de Gladys les paquets Wake-on-LAN et les recherches SSDP.
- Sans lien avec Philips ni TP Vision. Philips et Ambilight sont des marques de Koninklijke Philips N.V.
Paramètres de configuration
Voici les paramètres demandés par Philips TV dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre téléviseur Philips | section | Non | Philips Android TV, Google TV (2016 et après) ou Saphi. Allumez le téléviseur, lancez « Rechercher les téléviseurs » ci-dessous ou saisissez son adresse, et enregistrez. Un téléviseur Android s'appaire ensuite une fois, avec les deux actions d'appairage. Jusqu'à trois téléviseurs. |
| Adresse | string | Non | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : Philips et le modèle. |
| Deuxième téléviseur (facultatif) | section | Non | Mêmes champs, pour un autre téléviseur Philips. |
| Adresse | string | Non | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : Philips et le modèle. |
| Troisième téléviseur (facultatif) | section | Non | Mêmes champs, pour un autre téléviseur Philips. |
| Adresse | string | Non | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : Philips et le modèle. |
| Options | section | Non | |
| Wake-on-LAN | boolean | Non | Réveille un téléviseur dont le réseau s'endort quand il est éteint (Gladys envoie le paquet). |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture des téléviseurs. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités à l'ajout d'un appareil, et textes des listes et des événements de scène. |
Comment installer Philips TV dans Gladys
- Dans Gladys, ouvrez Intégrations : Philips TV 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-philips-tv: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). - 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-philips-tv.
Philips TV 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
Philips TV 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