Intégration domotique Android TV Remote, gratuite et open source

Intégration Gladys Assistant pour Android TV et Google TV via le protocole Remote v2.
Pilotez vos téléviseurs et boîtiers Android TV et Google TV depuis Gladys Assistant, sur le réseau local, via le protocole Remote v2 (TLS, ports 6466 et 6467) : celui de l'application Google TV de votre téléphone. Aucun mode développeur, aucun ADB à activer.
Fonctionnalités
Pour chaque TV appairée, un appareil Gladys avec :
- Marche / Arrêt, avec retour d'état : une TV qui ne répond plus sur le réseau est marquée éteinte.
- Volume (en %) et Sourdine, suivis en temps réel.
- Les touches de navigation (haut, bas, gauche, droite, OK, retour, accueil, menu) et de lecture (lecture, pause, stop, précédent, suivant, avancer, reculer).
- Un sélecteur Application pour lancer YouTube, Netflix, Prime Video, Disney+, Spotify, Plex, Twitch, Crunchyroll, YouTube Music, Apple TV, Arte, Molotov ou myCANAL, et vos propres applications. L'application au premier plan y est affichée.
- Wake-on-LAN facultatif : avec l'adresse MAC de la TV, « Allumer » réveille une TV totalement éteinte.
Appairage
Tout se saisit dans les actions de la page de configuration, rien à enregistrer entre les étapes.
- Allumez la TV.
- Étape 1 — Démarrer l'appairage : saisissez l'adresse IP de la TV (ex :
192.168.1.50), un nom si vous le souhaitez (ex :TV Salon) et son adresse MAC pour le Wake-on-LAN, puis exécutez l'action. Un code PIN s'affiche sur la TV. - Étape 2 — Valider le code PIN : saisissez le code et exécutez l'action dans la foulée, le code expire.
- Lancez une recherche d'appareils (onglet Découverte) pour ajouter la TV à vos appareils.
Répétez pour chaque TV. Réservez l'adresse IP de la TV dans votre box (réservation DHCP) : elle sert d'identifiant à l'appareil dans Gladys.
Les actions « Renseigner l'adresse MAC », « Retirer une TV appairée » et « Tester la connexion » proposent la liste de vos TV.
Widgets du tableau de bord
Avec Gladys 5.1 ou plus récent, quatre widgets (Modifier le tableau de bord → Ajouter un widget). Chacun a un réglage TV ; laissé vide, il affiche la première TV appairée. Ils montrent le dernier état remonté par la TV et se rafraîchissent dès qu'elle signale un changement.
- Télécommande — alimentation (Allumée, Éteinte, Injoignable), volume, sourdine, application au premier plan, et les touches Allumer / Éteindre, Accueil, Retour, OK.
- Lecture — l'application au premier plan et les touches Lecture / Pause, Stop, Précédent, Suivant.
- Applications — jusqu'à quatre boutons. Sans réglage, les quatre premières applications du lanceur ; sinon écrivez dans Application 1 à 4 le nom d'une application (majuscules et accents indifférents). Un nom inconnu est signalé avec les noms reconnus. L'application au premier plan est cochée. Pour plus de quatre boutons, ajoutez un second widget.
- Volume — une tuile liée à la fonctionnalité Volume de la TV (en direct), la sourdine, et les touches Vol −, Vol +, Sourdine (cochée quand elle est active).
Bon à savoir
- Les touches Marche/Arrêt et Sourdine sont des bascules sur la TV : l'intégration ne les envoie que si l'état connu diffère de l'état demandé.
- Le protocole n'a pas de volume absolu : le niveau demandé est atteint touche par touche.
- Sans Wake-on-LAN, « Allumer » ne fonctionne que si la TV est en veille réseau. Un adaptateur USB-Ethernet ne permet jamais le réveil : laissez le boîtier en veille plutôt qu'éteint.
- Une application absente de la TV est refusée par la TV, qui coupe la connexion au passage : masquez-la (« Applications à masquer ») ou corrigez son lien (« Applications personnalisées »).
- « The TV refused the pairing » : la TV a révoqué le certificat, refaites l'appairage.
Limites
- Une TV totalement éteinte, sans adresse MAC renseignée, ne peut être rallumée que depuis sa télécommande ou par HDMI-CEC.
- L'application au premier plan n'est reconnue que si elle fait partie du lanceur ; une application personnalisée ne l'est que si elle remplace une entrée du catalogue.
- Les widgets exigent Gladys 5.1 : une installation plus ancienne ne reçoit plus les mises à jour de l'intégration.
Paramètres de configuration
Voici les paramètres demandés par Android TV Remote dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Appairer une Android TV / Google TV | section | Non | Tout ce que vous avez à saisir se trouve dans les deux actions numérotées en bas de cette page — rien à enregistrer entre les deux. Allumez votre TV, lancez l'étape 1, puis l'étape 2, puis lancez une recherche d'appareils. Répétez l'opération pour chaque TV à ajouter. |
| Activer le lanceur d'applications | boolean | Non | Ajouter un sélecteur d'applications à chaque TV (Netflix, YouTube, Prime Video, Disney+, Spotify, Plex, Twitch, Crunchyroll, YouTube Music, Apple TV, Arte, Molotov, myCANAL). S'applique à toutes les TV appairées à la prochaine recherche d'appareils. |
| Applications à masquer | string | Non | Applications de la liste intégrée à retirer du sélecteur, séparées par des virgules — ex : « Spotify, Arte ». Une TV refuse le lancement d'une application qu'elle n'a pas. S'applique à la prochaine recherche d'appareils. |
| Applications personnalisées | string | Non | Applications à ajouter au sélecteur, sous la forme « Nom = lien » séparées par des points-virgules — ex : « France TV = https://www.france.tv ; VLC = vlc:// ». Le lien est un App Link https ou le scheme de l'application. Une entrée portant le nom d'une application intégrée la remplace (pour corriger son lien). S'applique à la prochaine recherche d'appareils. |
Comment installer Android TV Remote dans Gladys
- Dans Gladys, ouvrez Intégrations : Android TV Remote 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-integration-android-tv-remote:1.5.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-integration-android-tv-remote.
Android TV Remote 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
Android TV Remote 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