Intégration LG ThinQ pour Gladys Assistant

Découvrez et pilotez les appareils LG de votre compte ThinQ, via l'API officielle LG.

• Publiée par prohand
• Appareils
• Version 1.0.1
• Nécessite Gladys >=4.86.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Cette intégration connecte Gladys Assistant aux appareils enregistrés sur votre compte LG — climatiseur, lave-linge, sèche-linge, lave-vaisselle, réfrigérateur, four, purificateur d'air, aspirateur robot… — via l'API officielle LG ThinQ Connect.

C'est une intégration cloud : Gladys parle aux serveurs LG, et LG parle à vos appareils. Rien n'est rétro-conçu, et aucun mot de passe n'est stocké : le seul identifiant est un jeton que vous créez vous-même et que vous pouvez révoquer à tout moment.

Avant de commencer

Il vous faut :

• un compte LG ThinQ avec vos appareils déjà ajoutés dans l'application mobile LG ThinQ (cette intégration découvre les appareils, elle ne les appaire pas) ;
• des appareils en ligne dans l'application ;
• le pays dans lequel le compte LG a été créé — LG héberge les comptes sur des serveurs régionaux, et une mauvaise région répond simplement « utilisateur inconnu ».

Étape 1 — Créer un jeton d'accès personnel

1. Ouvrez https://connect-pat.lgthinq.com et connectez-vous avec le même compte LG que dans l'application ThinQ.
2. Cliquez sur Create New Token.
3. Donnez un nom au jeton (par exemple Gladys).
4. Cochez les autorisations correspondant aux appareils que vous voulez utiliser dans Gladys. Une autorisation manquante rend l'appareil invisible pour l'intégration : dans le doute, cochez tout.
5. Cliquez sur Create Token et copiez le jeton — LG ne l'affiche qu'une fois.

La documentation LG de cet écran : https://thinq.developer.lge.com/en/cloud/docs/thinq-connect/PAT-en/

Étape 2 — Configurer l'intégration dans Gladys

1. Ouvrez l'intégration LG ThinQ dans Gladys, onglet Configuration.
2. Collez le jeton dans Jeton d'accès personnel.
3. Choisissez le pays du compte LG.
4. Enregistrez.
5. Cliquez sur Tester la connexion : Gladys répond avec la région jointe et la liste des appareils trouvés. Si cela fonctionne, vos appareils apparaissent dans l'onglet Appareils en quelques secondes.

Les autres réglages sont optionnels :

• Intervalle de rafraîchissement — la fréquence de lecture de chaque appareil (5 minutes par défaut, une minute au plus rapide). LG limite le nombre d'appels d'API par client et chaque appareil coûte un appel par rafraîchissement : ne le baissez que si vous avez peu d'appareils.
• Unité de température — LG publie chaque température deux fois, en Celsius et en Fahrenheit. Seule l'unité choisie devient une fonctionnalité Gladys.
• Exposer toutes les propriétés numériques — désactivé par défaut. Activez-le pour récupérer aussi les décalages de programmation et les compteurs exposés par LG ; utile pour explorer ce que remonte un appareil précis.

Ce que vous obtenez

L'intégration lit le profil de chaque appareil — la description par LG de ce que ce modèle précis sait remonter et accepter — et en déduit les fonctionnalités Gladys. Ce que vous voyez dépend donc de votre matériel, pas d'une liste figée :

Ce que LG expose	Ce que vous obtenez dans Gladys
Marche/arrêt, et autres options on/off	Un interrupteur pilotable, utilisable dans les scènes
Température de consigne	Une consigne, avec les bornes de votre modèle
Température, humidité, PM2.5, PM10, CO2 mesurées	Des capteurs, avec historique et graphiques
Usure du filtre, batterie	Des capteurs, en pourcentage
Temps restant d'un cycle	Une durée, en heures et minutes
Porte ouverte/fermée	Un capteur d'ouverture
Mode en cours, état, nom du programme	Une fonctionnalité texte, utilisable comme déclencheur

Un appareil est lu dès son ajout, ses fonctionnalités portent donc une valeur immédiatement ; tout est ensuite rafraîchi selon l'intervalle configuré. Gladys affiche un badge sur chaque appareil : cloud quand LG répond, unreachable (orange) quand l'appareil est débranché ou hors réseau.

Piloter ce dont Gladys n'a pas de fonctionnalité

Les modes LG dépendent du modèle : votre climatiseur peut accepter COOL, HEAT, AIR_DRY, quand un autre accepte aussi ENERGY_SAVING. Les fonctionnalités Gladys couvrent l'universel (marche/arrêt, température, capteurs) ; tout le reste est accessible par deux boutons de l'onglet Configuration :

1. Lister les propriétés — choisissez un appareil, et Gladys affiche chaque propriété acceptée avec les valeurs exactes autorisées, par exemple :

   airConJobMode.currentJobMode = COOL | HEAT | AIR_DRY
   temperatureInUnits.targetTemperatureC = 18..30, step 1
   airFlow.windStrength = LOW | MID | HIGH

2. Envoyer une commande — choisissez l'appareil, collez le nom de la propriété et la valeur. La commande est vérifiée contre le profil avant l'envoi : une faute de frappe est refusée avec la liste des valeurs autorisées, plutôt qu'un échec silencieux.

Dépannage

« LG a refusé les identifiants » — le jeton ou le pays est incorrect. Les jetons sont liés au compte qui les a créés : vérifiez que vous utilisez le même compte LG que dans l'application ThinQ, et choisissez le pays de création du compte.

Un appareil manque — soit son autorisation n'était pas cochée à la création du jeton (recréez un jeton avec les bonnes autorisations), soit il a été ajouté dans l'application LG après la dernière lecture de Gladys. Cliquez sur Rafraîchir la liste des appareils.

Un appareil affiche un badge orange unreachable — LG le signale comme non connecté. Vérifiez qu'il est alimenté et connecté au Wi-Fi dans l'application LG ThinQ ; le badge disparaît au rafraîchissement suivant.

Un appareil que je viens d'ajouter affiche « pas de valeur récente » — l'appareil est lu au moment même de son ajout : cela signifie donc que LG n'avait rien à remonter à cet instant, en général parce que l'appareil est hors réseau (vérifiez le badge orange). Le rafraîchissement suivant remplit les fonctionnalités dès que LG répond de nouveau.

« Quota d'appels dépassé » — augmentez l'intervalle de rafraîchissement. LG compte les appels de chaque client, et un rafraîchissement coûte un appel par appareil.

Une commande est refusée — LG rejette les commandes qu'un appareil ne peut pas honorer dans son état actuel (démarrer un lave-linge dont la porte est ouverte, changer le mode alors qu'il est éteint). La raison s'affiche sous le bouton et dans les logs de l'intégration.

Vie privée

Le jeton d'accès personnel est stocké chiffré par Gladys et n'est jamais renvoyé à votre navigateur. Il peut être révoqué à tout moment depuis https://connect-pat.lgthinq.com, ce qui coupe immédiatement l'accès de cette intégration sans toucher à votre compte LG.

Paramètres de configuration

Voici les paramètres demandés par LG ThinQ dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Connectez votre compte LG	section	Non	Cette intégration utilise l'API officielle LG ThinQ Connect. Connectez-vous sur la page LG ci-dessous avec le compte LG sur lequel vos appareils sont enregistrés, créez un jeton d'accès personnel (PAT), cochez les autorisations des appareils souhaités, puis collez le jeton ici.
Jeton d'accès personnel	secret	Oui	Le jeton créé sur la page LG ci-dessus. Il est stocké chiffré et jamais renvoyé au navigateur.
Pays du compte LG	select	Oui	LG héberge les comptes sur des serveurs régionaux : choisissez le pays de création du compte LG, pas votre pays de résidence actuel.
Comportement	section	Non	LG limite le nombre d'appels d'API par client. Chaque appareil coûte un appel par rafraîchissement : gardez un intervalle confortable si vous possédez beaucoup d'appareils.
Intervalle de rafraîchissement (s)	number	Non	Fréquence de lecture de chaque appareil, en secondes.
Unité de température	select	Non	LG publie chaque température deux fois, en Celsius et en Fahrenheit. Seule l'unité choisie devient une fonctionnalité Gladys.
Exposer toutes les propriétés numériques	boolean	Non	Créer aussi des fonctionnalités pour les propriétés numériques sans signification évidente (décalages de programmation, compteurs). Utile pour explorer ce que remonte un appareil.

Comment installer LG ThinQ dans Gladys

1. Dans Gladys, ouvrez Intégrations : LG ThinQ apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-lg-thinq: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).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-lg-thinq.

LG ThinQ nécessite Gladys >=4.86.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

LG ThinQ 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 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

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂