Intégration LG webOS pour Gladys Assistant

Contrôlez localement une télévision LG webOS depuis Gladys Assistant.
Cette intégration contrôle localement une TV LG webOS depuis Gladys Assistant.
Découverte automatique
- Allumez la TV, puis installez et démarrez l'intégration sans renseigner d'adresse IP.
- Ouvrez l'onglet Découvrir puis cliquez sur Scanner.
- Gladys envoie une recherche SSDP pour le service webOS
urn:lge-com:service:webos-second-screen:1depuis le réseau hôte. - L'intégration récupère le nom, le modèle et l'identifiant UDN de chaque TV depuis sa description UPnP.
- Ajoutez votre TV dans Gladys. Son IP et son UDN sont alors conservés automatiquement.
- Lors de la première connexion, une demande d'association webOS s'affiche sur la TV : acceptez-la avec la télécommande.
L'UDN fourni par la TV est utilisé comme identifiant stable. Ainsi, un changement d'adresse IP détecté lors d'un nouveau scan met à jour la connexion sans recréer le device.
Wake-on-LAN
SSDP ne fournit pas de manière fiable l'adresse MAC de la TV. Le contrôle de la TV allumée et l'extinction fonctionnent sans adresse MAC, mais celle-ci est nécessaire pour allumer la TV depuis Gladys avec le Wake-on-LAN.
Après avoir ajouté une TV, utilisez l'action Configurer une TV dans la configuration de l'intégration, sélectionnez la TV concernée puis renseignez son adresse MAC.
Chaque TV ajoutée possède sa propre configuration, ce qui permet d'utiliser le Wake-on-LAN avec plusieurs TV LG webOS.
Il est recommandé de conserver un bail DHCP fixe pour chaque TV, même si la découverte peut retrouver et mettre à jour une nouvelle adresse IP.
Connexion
Le mode Automatique tente ws://TV:3000 puis wss://TV:3001. Sur certains firmwares récents, webOS impose le port sécurisé avec un certificat auto-signé.
L'intégration maintient une connexion WebSocket avec chaque TV configurée. En cas de perte inattendue de la connexion, elle tente automatiquement de se reconnecter. Après un démarrage via Wake-on-LAN, elle attend que webOS soit disponible puis rétablit automatiquement la connexion.
L'intégration expose l'alimentation, le volume, le mute, lecture/pause/stop, volume +/-, chaîne +/- et l'envoi de notifications toast.
Paramètres de configuration
Voici les paramètres demandés par LG webOS dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| TV LG webOS | section | Non | Commencez par l'onglet Découvrir. La TV doit être allumée pour être détectée via SSDP. Lors de la première connexion, une demande d'autorisation s'affichera sur la TV et devra être acceptée avec la télécommande. Après avoir ajouté une TV, utilisez l'action Configurer une TV ci-dessous pour renseigner son adresse MAC si vous souhaitez utiliser le Wake-on-LAN. |
| Mode de connexion | select | Non |
Comment installer LG webOS dans Gladys
- Dans Gladys, ouvrez Intégrations : LG webOS 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/vincentbesseau/gladys-lg-webos:2.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/vincentBesseau/gladys-lg-webos.
LG webOS nécessite Gladys >=4.86.1. 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
LG webOS 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 vincentBesseau, 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