Intégration domotique Govee, gratuite et open source
Ampoules, rubans LED et lampes Govee en réseau local (API LAN), API cloud en option.
Publiée par guim31
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos ampoules, rubans LED, lampadaires et guirlandes Govee Wi-Fi depuis Gladys, en réseau local : sans cloud, sans compte, sans latence. Une clé d'API Govee gratuite ajoute, si vous le souhaitez, les appareils que l'API locale ne couvre pas (prises, thermomètres, humidificateurs…).
Développée sans le matériel : retours bienvenus. Cette intégration a été écrite d'après la documentation officielle de Govee et les tests des projets open source qui utilisent l'API locale de Govee, pas sur de vrais appareils. Si quelque chose ne fonctionne pas avec votre modèle, dites-le sur le forum Gladys ou dans une issue GitHub, avec la référence de votre modèle (elle commence par H, par exemple H6008) et le résultat de Rechercher et diagnostiquer.
Ce que vous obtenez
| Appareil | Dans Gladys | Comment |
|---|---|---|
| Ampoules, rubans LED, lampes, barres lumineuses, guirlandes | Marche/arrêt, luminosité, couleur, température de couleur (blancs), selon le modèle | Réseau local (API LAN) |
| Lampes Govee sans contrôle LAN | Les mêmes fonctionnalités | Cloud (clé d'API) |
| Prises connectées | Marche/arrêt | Cloud (clé d'API) |
| Thermomètres-hygromètres Wi-Fi | Température, humidité | Cloud (clé d'API) |
| Humidificateurs, purificateurs, ventilateurs, chauffages | Marche/arrêt, et leurs options marche/arrêt exposées par le cloud (veilleuse, oscillation…) | Cloud (clé d'API) |
En plus des fonctionnalités des appareils :
- un widget de tableau de bord Préréglages Govee : blanc chaud, lumière du jour, votre couleur préférée et des scènes intégrées Govee, en un geste chacun ;
- une action de scène Lancer une scène Govee : lever de soleil, coucher de soleil, cinéma, bougie, romantique, scintillement… sur toute lampe qui connaît les scènes Govee ;
- un badge sur chaque appareil, qui indique si Gladys le joint en local ou par le cloud.
Le curseur de température de couleur suit la plage propre à chaque modèle (par exemple de 2700 K à 6500 K sur le lampadaire H6076, de 2000 K à 9000 K sur la plupart des ampoules). Les températures s'affichent en °C ou en °F selon votre profil Gladys : les thermomètres Govee mesurent en Fahrenheit, Gladys convertit si vous avez choisi Celsius.
Avant de commencer : activer le contrôle LAN
L'API locale de Govee est désactivée par défaut, sur chaque lampe :
- Ouvrez l'application Govee Home et touchez la lampe.
- Touchez la roue dentée (Réglages) en haut à droite.
- Activez LAN Control.
Pas d'interrupteur LAN Control ? Votre modèle (ou son micrologiciel) ne propose pas l'API locale : mettez le micrologiciel à jour depuis le même écran de réglages, ou utilisez la clé d'API cloud (plus bas). Les appareils Govee uniquement Bluetooth (sans Wi-Fi) sont hors de portée de Gladys.
Relevez ensuite l'adresse IP de chaque lampe. Votre box ou votre routeur
les liste parmi les appareils connectés : les lampes Govee y apparaissent
souvent sous le nom ihoment_ suivi du modèle, par exemple
ihoment_H6008_A1B2. Nous conseillons de donner à chaque lampe une adresse
IP fixe (un « bail DHCP statique » dans les réglages de la box) :
l'intégration suit une lampe qui change d'adresse tant qu'elle reste dans la
plage saisie, pas au-delà.
Installation
Installez Govee depuis le catalogue d'intégrations de Gladys (Gladys 5.1 ou plus récent). L'écran d'installation vous demande d'autoriser l'intégration à écouter les annonces réseau UDP sur le port 4002 : acceptez. C'est le port sur lequel les lampes Govee répondent (voir Comment ça marche).
Configuration
Dans l'onglet Configuration de l'intégration :
- Adresses IP ou plages des lampes : les adresses de vos lampes, séparées
par des virgules. Vous pouvez aussi saisir une plage (
192.168.1.20-60) ou votre réseau entier (192.168.1.0/24) : l'intégration y cherche les lampes. 1024 adresses au plus. - Rafraîchissement de l'état des lampes : la fréquence à laquelle Gladys interroge les lampes, pour voir ce que vous changez depuis l'application Govee ou une télécommande (toutes les 30 secondes par défaut). Les commandes envoyées depuis Gladys sont confirmées aussitôt, quel que soit ce réglage.
- Langue des noms de fonctionnalités : noms anglais, français, allemands ou espagnols des
fonctionnalités des appareils que vous ajouterez ensuite (Éclairage,
Luminosité…). Le nom des appareils vient de l'application Govee quand l'API
cloud est configurée, sinon il s'écrit
Govee H6008 A1B2(modèle et fin de l'identifiant) : renommez-les dans Gladys à votre guise. - Clé d'API Govee (facultative) et Rafraîchissement par le cloud : voir L'API cloud.
- Préférer la connexion locale : quand une lampe est joignable à la fois en local et par le cloud, passer par le réseau local (activé par défaut). Si une lampe ne répond plus en local, Gladys la pilote par le cloud et le badge passe à l'orange pour vous le signaler.
Enregistrez, puis ouvrez l'onglet Découverte : vos appareils Govee y sont listés, ajoutez-les à Gladys. Le bouton Scanner relance une recherche à tout moment.
L'API cloud (facultative)
Sans clé, l'intégration est 100 % locale et ne contacte jamais Govee. Avec une clé, Gladys joint aussi les appareils sans API locale, et passe par le cloud quand une lampe ne répond pas en local.
La clé est gratuite : dans l'application Govee Home, ouvrez votre Profil, touchez la roue dentée (Réglages), puis Apply for API Key. Govee envoie la clé par e-mail en quelques minutes. Collez-la dans le champ Clé d'API Govee.
Quota. Govee autorise 10 000 requêtes par jour et par compte. L'intégration compte ses propres appels (le compteur repart à zéro à minuit UTC, soit 1 h ou 2 h du matin en France) et :
- liste vos appareils au démarrage, toutes les 6 heures et quand vous cliquez sur Scanner ;
- relève l'état des appareils qu'elle pilote par le cloud une fois par Rafraîchissement par le cloud (10 minutes par défaut), jamais celui des lampes jointes en local ;
- allonge d'elle-même cet intervalle si votre nombre d'appareils dépassait 8 000 requêtes par jour, et cesse de relever les états à 8 000 : les 2 000 dernières requêtes restent disponibles pour vos commandes.
Avec 10 appareils cloud rafraîchis toutes les 10 minutes, cela fait environ 1 450 requêtes par jour.
Actions
Dans l'onglet Configuration :
- Rechercher et diagnostiquer : lance une recherche et indique ce qu'elle a trouvé : combien de lampes répondent en local, les entrées du champ d'adresses qu'elle n'a pas su lire, le chemin qu'empruntent les réponses, et l'état de la connexion cloud (nombre d'appareils, requêtes du jour).
- Identifier un appareil : choisissez un appareil, il clignote deux fois puis revient à son état. Pratique pour distinguer des ampoules identiques.
Scènes
L'action Lancer une scène Govee (éditeur de scènes, catégorie Intégrations) lance une des scènes intégrées Govee sur une lampe : lever de soleil, coucher de soleil, cinéma, rendez-vous, romantique, scintillement, bougie, respiration, flocon de neige, énergique, croisement. Elle allume la lampe d'abord si besoin. Elle fonctionne sur les lampes pilotées en local dont le modèle connaît les scènes Govee.
Pour régler une couleur, un blanc ou la luminosité dans une scène, utilisez l'action habituelle Contrôler un appareil de Gladys sur les fonctionnalités de la lampe.
Tableau de bord
Ajoutez le widget Préréglages Govee à un tableau de bord et choisissez une lampe dans ses réglages. Il affiche la luminosité et le mode en cours de la lampe, et jusqu'à quatre boutons, selon ce que permet le modèle. Chaque bouton agit en un geste :
- Blanc chaud (2700 K) et Lumière du jour (6500 K), ajustés à la plage du modèle ;
- votre couleur (bleu par défaut), choisie parmi huit couleurs nommées dans les réglages du widget ;
- votre scène (Coucher de soleil par défaut) parmi les scènes intégrées Govee et, sur les lampes sans blancs, une seconde scène (Bougie par défaut).
Changez la couleur et les scènes dans les réglages du widget. Le préréglage actif est marqué d'une coche.
Comment ça marche
Les lampes Govee répondent à l'API locale sur le port UDP 4002 de l'ordinateur qui les interroge. Gladys fait tourner chaque intégration dans son propre conteneur, derrière un pont réseau : la recherche automatique de Govee (un message multicast) ne le traverse pas, d'où le besoin des adresses de vos lampes, ou d'une plage à parcourir.
L'intégration envoie ses requêtes directement à chaque lampe. Les réponses reviennent soit directement à l'intégration, soit, quand le réseau ne les laisse pas passer, à Gladys elle-même, qui écoute un instant le port 4002 pour le compte de l'intégration (l'autorisation acceptée à l'installation). Rechercher et diagnostiquer vous dit lequel des deux chemins votre réseau emprunte. Les commandes (marche/arrêt, couleur…) n'attendent pas de réponse et vont toujours directement à la lampe.
Limites
- Pas encore pris en charge : les couleurs par segment (les rubans RGBIC sont pilotés d'un bloc), les scènes DIY, le mode musique, les scènes de l'application Govee au-delà des onze scènes intégrées, et les scènes cloud.
- Les états sont relevés, pas poussés : un changement fait depuis l'application Govee ou une télécommande apparaît au rafraîchissement suivant (30 secondes par défaut).
- Un autre programme Govee sur le même ordinateur (l'intégration « Govee lights local » de Home Assistant, Homebridge…) écoute lui aussi le port 4002 et peut recevoir les réponses destinées à Gladys : les lampes paraissent alors injoignables alors que les commandes passent. Faites-le tourner sur un autre ordinateur, ou utilisez la clé d'API cloud.
- Certaines lampes Govee récentes gèrent aussi Matter : vous pouvez les ajouter à Gladys par son intégration Matter à la place.
- Govee ne publie pas la plage de température de couleur de chaque modèle : quand l'intégration ne connaît pas votre modèle, elle utilise 2000 K à 9000 K, la plage de la documentation Govee. Les modèles inconnus reçoivent toutes les fonctionnalités d'éclairage : dites-nous lesquelles fonctionnent vraiment.
Dépannage
Aucune lampe trouvée. Vérifiez que LAN Control est activé dans l'application Govee pour chaque lampe, que les adresses IP sont justes (liste des appareils de votre box) et que les lampes sont sur le même réseau que Gladys. Lancez ensuite Rechercher et diagnostiquer.
Une lampe est « injoignable ». Elle n'a pas répondu aux trois dernières interrogations : elle est peut-être débranchée, a changé d'adresse IP, ou ses réponses sont captées par un autre programme (voir Limites). Lancez Rechercher et diagnostiquer.
« Gladys a refusé la capture sur le port 4002 ». Mettez Gladys à jour, et vérifiez que vous avez accepté l'autorisation réseau à l'installation de l'intégration (réinstallez-la au besoin).
« Clé d'API Govee refusée ». Vérifiez la clé dans la configuration ; demandez-en une nouvelle dans l'application Govee si besoin.
Pour plus de détails, ouvrez les logs de l'intégration depuis Gladys : chaque lampe trouvée, chaque requête refusée et chaque bascule vers le cloud y est écrite.
Cette intégration n'est ni affiliée à Govee, ni approuvée ou sponsorisée par Govee. « Govee » est une marque de son propriétaire.
Paramètres de configuration
Voici les paramètres demandés par Govee dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Contrôle local (LAN) | section | Non | Dans l'application Govee Home, ouvrez chaque lampe, touchez la roue dentée et activez « LAN Control ». Saisissez ensuite les adresses IP de vos lampes ci-dessous (votre box les affiche), ou une plage à parcourir. |
| Adresses IP ou plages des lampes | string | Non | Séparées par des virgules. Une adresse (192.168.1.42), une plage (192.168.1.20-60) ou un réseau entier (192.168.1.0/24), 1024 adresses au plus. |
| Rafraîchissement de l'état des lampes | select | Non | Fréquence à laquelle les lampes sont interrogées (changements faits depuis l'application Govee ou une télécommande). Les commandes Gladys sont confirmées aussitôt. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités des nouveaux appareils (Éclairage, Luminosité…). |
| API cloud Govee (facultative) | section | Non | Sans clé, l'intégration reste 100 % locale. Avec une clé, Gladys atteint aussi les appareils sans contrôle LAN (prises, thermomètres, humidificateurs…) et passe par le cloud quand une lampe ne répond pas en local. Clé gratuite dans l'application Govee Home : Profil, Réglages, Apply for API Key. Govee autorise 10 000 requêtes par jour. |
| Clé d'API Govee | secret | Non | |
| Rafraîchissement par le cloud | select | Non | Pour les appareils joints par le cloud. Allongé automatiquement si besoin pour rester dans le quota quotidien. |
Comment installer Govee dans Gladys
- Dans Gladys, ouvrez Intégrations : Govee 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-govee:1.1.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-govee.
Govee 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
Govee 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