Intégration domotique Sony Bravia TV, gratuite et open source
Téléviseurs Sony Bravia : marche, volume, entrées, applications et touches, en local.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos téléviseurs Sony Bravia depuis Gladys, sur votre réseau local : allumer et éteindre, régler le volume, changer d'entrée, ouvrir une application, changer de chaîne, appuyer sur n'importe quelle touche de la télécommande, depuis le tableau de bord ou depuis une scène. Et réagir à ce qui se passe à l'écran : « quand la console allume le téléviseur sur HDMI 2, tamiser 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 réponses documentées par Sony (API REST Bravia et IRCC-IP) et sur celles de la bibliothèque libre pybravia, avec un téléviseur simulé, pas avec un vrai Bravia. Si quelque chose ne fonctionne 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 Sony Bravia Android TV ou Google TV (2015 et après), sur le même réseau local que Gladys, avec une adresse IP fixe (une réservation DHCP dans votre box ou routeur).
- Le contrôle IP activé sur le téléviseur. Les menus varient selon le
modèle ; en général Paramètres → Réseau et Internet → Réseau domestique →
Contrôle IP (ou Paramètres → Réseau → Configuration du réseau domestique
→ Contrôle IP) :
- Authentification : Normale et clé pré-partagée ;
- Clé pré-partagée : saisissez une clé de votre choix, par exemple
gladys2026; - le contrôle IP simple n'est pas nécessaire.
- Le démarrage à distance activé (Paramètres → Réseau et Internet → Démarrage à distance) : sans lui, un téléviseur en veille ne peut pas être allumé par le réseau.
Configuration
- Installez l'intégration depuis le catalogue de Gladys.
- Dans Configuration, saisissez l'Adresse de votre téléviseur (par
exemple
192.168.1.20), puis authentifiez-le de l'une des deux façons ci-dessous, et donnez-lui si vous voulez un Nom. Deux ou trois téléviseurs ? Remplissez aussi les sections Deuxième téléviseur et Troisième téléviseur. - Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton indique, pour chaque téléviseur, s'il répond, son modèle et s'il est allumé.
- 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'y est pas.
Avec une clé pré-partagée (recommandé)
Saisissez la clé réglée sur le téléviseur dans Clé pré-partagée. Rien d'autre à faire.
Avec un code PIN
Sans clé pré-partagée, le téléviseur peut s'appairer avec Gladys comme avec son application mobile :
- Laissez Clé pré-partagée vide, saisissez l'adresse, enregistrez.
- Allumez le téléviseur, puis cliquez sur Afficher un code PIN sur le téléviseur (choisissez le téléviseur) : un code à 4 chiffres s'affiche à l'écran.
- Saisissez-le dans Code PIN (sans clé), enregistrez. Gladys s'enregistre sur le téléviseur sous le nom Gladys Assistant, et s'enregistre à nouveau avec le même code quand le téléviseur le demande (environ toutes les deux semaines).
Les options en bas de la page :
- Wake-on-LAN (activé par défaut) : beaucoup de Bravia coupent leur réseau en veille. Gladys demande alors à son cœur d'envoyer un paquet Wake-on-LAN à l'adresse MAC donnée par le téléviseur, ce 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 d'alimentation.
- Pas du volume : la variation de chaque appui sur Volume + et Volume −.
- Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités quand vous ajoutez 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 passe par le démarrage à distance, ou par le Wake-on-LAN quand le téléviseur ne répond plus du tout. |
| Volume | Le volume des haut-parleurs du téléviseur, de 0 à 100, en curseur. |
| Diminuer le volume | Baisse le volume du pas configuré (les touches de la télécommande quand une barre de son prend le son). |
| Augmenter le volume | Monte le volume de la même façon. |
| Muet | Coupe ou rétablit le son. |
| Entrée | L'entrée à l'écran (HDMI 1, HDMI 2…, avec les noms que vous leur avez donnés sur le téléviseur), et pour passer sur une autre. Autre (TV, applis) indique une application ou le tuner, et la choisir appuie sur Accueil. |
| Application | Ouvre une des applications du téléviseur. Affiche l'application ouverte par Gladys, jusqu'au prochain changement d'écran ; Écran d'accueil appuie sur Accueil. |
| Chaîne | Le numéro de la chaîne à l'écran, et pour passer sur 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 : une entrée, 5 · France 5 — programme, Application ou écran d'accueil, ou Éteinte. |
Les listes d'entrées et d'applications sont lues sur le téléviseur (toutes les 30 minutes et toutes les 6 heures, quand il est allumé) et gardées par l'intégration : elles sont là même quand le téléviseur dort. Une commande qui a besoin de l'écran (une entrée, une application, une chaîne) allume d'abord le téléviseur et l'attend, jusqu'à 20 secondes.
Tableau de bord
Trois widgets, à placer côte à côte ; chacun montre un téléviseur (le premier de la configuration quand aucun n'est choisi dans ses réglages). Le cœur autorise quatre boutons par widget, d'où les trois.
- Télécommande Bravia : l'état du téléviseur, ce qui est à l'écran, le volume, et les boutons Allumer (ou Éteindre), Volume −, Volume + et Muet.
- Touches Bravia : 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, Entrée, ou Lecture et Pause…
- Raccourcis Bravia : jusqu'à quatre entrées ou applications favorites,
saisies par leur nom dans les réglages (
HDMI 2,PS5,Netflix…) ; les entrées branchées quand aucun nom 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 : entrée, chaîne ou application changée : ce qui est à l'écran a
changé, allumage compris. Filtres : le téléviseur, ce qui est désormais à
l'écran (entrée, chaîne, application ou écran d'accueil), son nom exactement
comme le téléviseur l'affiche (PS5, HDMI 2, TF1), 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 (input, channel, app), le nom (de
l'entrée, de la chaîne, ou de l'application ouverte par Gladys), le numéro de
chaîne, le programme, et qui l'a changé.
L'API du téléviseur ne dit jamais quelle application est au premier plan : une application ouverte depuis la télécommande donne Application ou écran d'accueil ; passer d'une application à une autre ne déclenche rien.
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,prime video: majuscules, accents et espaces ne comptent pas). Sortie : l'application ouverte. - Choisir une entrée du téléviseur : par son nom (
HDMI 2) ou l'étiquette réglée sur le téléviseur (PS5). Sortie : l'entrée choisie. - Envoyer une touche de télécommande : Accueil, Retour, flèches, OK, Entrée, volume, chaînes, lecture, couleurs, chiffres, d'une à dix fois. Sortie : les appuis envoyés.
Les deux premières 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 et Chaîne 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, tamiser les lumières du salon. - La console est allumée : déclencheur TV : entrée, chaîne ou application
changée, désormais à l'écran Entrée, nom
PS5: passer les lumières en ambiance jeu. - 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.
- Journal : à 20 h, Choisir une entrée du téléviseur
Freebox, puis Envoyer une touche de télécommande2.
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, allumez-le, et vérifiez que le contrôle IP est activé.
- « Clé ou code PIN refusé » : la clé pré-partagée diffère de celle du téléviseur, ou le code PIN a expiré : cliquez à nouveau sur Afficher un code PIN sur le téléviseur.
- « Le téléviseur demande une clé pré-partagée ou un code PIN » : aucun des deux n'est saisi.
- « Pas de contrôle IP Bravia à cette adresse » : un autre appareil répond à cette adresse, ou le contrôle IP est désactivé.
- Le téléviseur ne s'allume pas : activez le démarrage à distance sur le téléviseur. Si son réseau s'endort en veille, gardez le Wake-on-LAN activé ; le Wake-on-LAN doit aussi être autorisé sur le téléviseur (souvent avec le démarrage à distance), et il ne traverse ni routeur ni VLAN.
- Les boutons de volume ne font rien sur la barre de son : l'intégration envoie alors les touches de la télécommande, que la barre de son suit en HDMI-CEC ; le curseur Volume ne règle que les haut-parleurs du téléviseur.
- Une application est introuvable : son nom doit faire partie du nom affiché par le téléviseur ; la liste est relue quand un nom est introuvable.
- Les logs de l'intégration (onglet Configuration) disent ce que répond chaque téléviseur ; aucune clé ni aucun code PIN n'y est jamais écrit.
Limites
- Développée sans le matériel : les comportements viennent de la documentation de Sony et de pybravia, pas d'un vrai téléviseur.
- Les Bravia Android TV et Google TV avec contrôle IP. Les Bravia plus anciens (avant 2015) et les écrans professionnels sans contrôle IP ne sont pas pris en charge.
- L'API ne dit ni quelle application est au premier plan, ni le programme d'une source HDMI.
- Chaînes : celles du tuner du téléviseur (sources
tv:), lues une fois par jour. - Tout reste sur votre réseau local : pas de cloud, pas de compte Sony. L'intégration ne parle qu'aux téléviseurs configurés, et demande au cœur de Gladys les paquets Wake-on-LAN.
- Non affiliée à Sony. Bravia est une marque de Sony Group Corporation.
Paramètres de configuration
Voici les paramètres demandés par Sony Bravia TV dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre téléviseur Bravia | section | Non | Sony Bravia Android TV ou Google TV. Sur le téléviseur, dans Réseau, Réseau domestique, Contrôle IP : réglez Authentification sur « Normale et clé pré-partagée », saisissez une clé, et activez le démarrage à distance. Jusqu'à trois téléviseurs. |
| Adresse | string | Oui | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Clé pré-partagée | secret | Non | La clé saisie sur le téléviseur, dans Contrôle IP (recommandé). |
| Code PIN (sans clé) | secret | Non | Seulement sans clé pré-partagée : lancez « Afficher un code PIN sur le téléviseur » ci-dessous, puis saisissez les 4 chiffres affichés. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : BRAVIA et le modèle. |
| Deuxième téléviseur (facultatif) | section | Non | Mêmes champs, pour un autre téléviseur Bravia. |
| Adresse | string | Non | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Clé pré-partagée | secret | Non | La clé saisie sur le téléviseur, dans Contrôle IP (recommandé). |
| Code PIN (sans clé) | secret | Non | Seulement sans clé pré-partagée : lancez « Afficher un code PIN sur le téléviseur » ci-dessous, puis saisissez les 4 chiffres affichés. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : BRAVIA et le modèle. |
| Troisième téléviseur (facultatif) | section | Non | Mêmes champs, pour un autre téléviseur Bravia. |
| Adresse | string | Non | Adresse IP du téléviseur. Fixez-la dans votre box ou routeur. |
| Clé pré-partagée | secret | Non | La clé saisie sur le téléviseur, dans Contrôle IP (recommandé). |
| Code PIN (sans clé) | secret | Non | Seulement sans clé pré-partagée : lancez « Afficher un code PIN sur le téléviseur » ci-dessous, puis saisissez les 4 chiffres affichés. |
| Nom | string | Non | Nom de l'appareil dans Gladys. Vide : BRAVIA 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. |
| Pas du volume | select | Non | Variation de chaque appui sur Volume + et Volume −. |
| 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 Sony Bravia TV dans Gladys
- Dans Gladys, ouvrez Intégrations : Sony Bravia 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-sony-bravia:1.0.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/guim31/gladys-sony-bravia.
Sony Bravia 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
Sony Bravia 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 externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation