À propos
Govee Cloud Integration est un composant personnalisé qui contrôle les lumières Govee et d'autres appareils connectés via le cloud de Govee. Elle prend en charge les lumières, les prises, les ventilateurs, les humidificateurs, les radiateurs, les thermomètres, les moniteurs de qualité de l'air, ainsi que les capteurs de présence et de fuite, avec des entités créées à partir des capacités que Govee signale pour chaque appareil. Ajouter l'adresse e-mail et le mot de passe du compte Govee en plus de la clé API active les mises à jour en temps réel via MQTT et la prise en charge des capteurs de fuite reliés à un hub. Les appareils dont l'API LAN de Govee est activée sont détectés automatiquement et contrôlés en local, avec le cloud en secours. Les options comprennent l'intervalle d'interrogation, un budget quotidien de requêtes cloud, des sélecteurs de scènes et de scènes DIY, les appareils de groupe et des modes de segments pour les lumières RGBIC. La configuration se fait dans l'interface avec une clé API développeur Govee.
Résumé automatique du README et du code de lasswellt/govee-homeassistant, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Chauffe-eau
- Humidificateurs
- Ventilateurs
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Clé API Govee
- Clé APILa clé API de ton compte Govee Developer (une longue chaîne de lettres et de chiffres).
Compte Govee (facultatif)
- E-mail de l'app GoveeL'adresse e-mail que tu utilises pour te connecter à l'app mobile Govee.
- Mot de passe de l'app GoveeLe mot de passe que tu utilises pour te connecter à l'app mobile Govee (pas au site web).
Code de vérification Govee
- Code de vérificationConsulte ta boîte e-mail pour trouver un code envoyé par Govee.
Réauthentifier Govee
- Clé APIUne clé API valide du compte Govee Developer avec lequel cette intégration a été configurée.
Reconfigurer Govee
- Clé APITa clé API Govee Developer provenant de developer.govee.com.
- E-mail de l'app Govee (facultatif)E-mail de l'app mobile Govee. Laisse vide pour supprimer les mises à jour en temps réel.
- Mot de passe de l'app Govee (facultatif)Mot de passe de l'app mobile Govee. Laisse vide pour conserver le mot de passe existant.
Après la mise en place
- Intervalle d’interrogation (secondes)Fréquence à laquelle l’état de chaque appareil est interrogé via l’API cloud de Govee. Les mises à jour en temps réel par MQTT et en réseau local arrivent entre deux interrogations. Plage de 30 à 300 secondes, 60 par défaut. Chaque interrogation consomme une requête par appareil sur la limite de Govee de 100 par minute et de 10 000 par jour.
- Budget quotidien de requêtes cloudNombre de requêtes cloud Govee par jour que cette intégration vise à consacrer à l’interrogation. L’intervalle d’interrogation est allongé automatiquement pour que la consommation du jour atteigne ce chiffre. Le plafond de Govee est de 10 000 par jour ; la valeur par défaut de 9 000 laisse une marge pour les commandes, la recherche de scènes et la redécouverte des appareils.
- Intervalle d’interrogation des capteurs de fuite (secondes)Fréquence à laquelle les détecteurs d’eau et de fuite Govee autonomes (par exemple H5054) sont vérifiés. Ces capteurs fonctionnent uniquement en radiofréquence et n’ont pas de canal de notification, donc une fuite peut apparaître avec un retard allant jusqu’à cette durée. Une valeur plus basse réagit plus vite mais fait plus d’appels à l’API du compte ; augmente-la si tu as beaucoup de détecteurs. Plage de 60 à 3600 secondes, 120 par défaut. Nécessite une connexion par e-mail et mot de passe ; ignoré si tu n’as pas de tels détecteurs.
- Intervalle d’interrogation des thermomètres à sonde (secondes)Fréquence à laquelle un thermomètre à sonde (cuisson) armé, comme le H5192, est lu via AWS IoT tant que son interrupteur Live polling est activé. Ces appareils n’envoient jamais de mesure d’eux-mêmes, donc cet intervalle correspond à la fréquence de mise à jour. Cela coûte de la batterie et non du quota d’API. Plage de 10 à 600 secondes, 30 par défaut. Nécessite une connexion par e-mail et mot de passe.
- Intervalle de nouvelle demande d’état MQTT (secondes)Fréquence à laquelle l’état actuel de chaque appareil connecté en MQTT est demandé via AWS IoT. Les appareils répondent surtout à des demandes et n’envoient pas d’état de manière autonome ; cela reproduit ce que fait l’app Govee elle-même tant que sa liste d’appareils est affichée, ce qui permet de garder l’état à jour sans ouvrir l’app. Une valeur plus basse réagit plus vite mais publie plus de messages par appareil ; augmente-la si tu as beaucoup d’appareils. Plage de 60 à 3600 secondes, 300 par défaut. Mets 0 pour désactiver la nouvelle demande et te fier à ce que les appareils envoient d’eux-mêmes. Les demandes partent à raison d’un appareil par seconde ; un appareil dont la demande fait fermer la session AWS IoT deux fois est exclu jusqu’au prochain rechargement (un avertissement le nomme). Si la session se ferme juste après des demandes à trois modèles différents d’affilée sans aucune réponse, AWS IoT refuse les demandes d’état pour tout le compte, et la nouvelle demande s’arrête jusqu’au prochain rechargement (un avertissement l’indique). Nécessite une connexion par e-mail et mot de passe (identifiants MQTT) ; ignoré quand MQTT n’est pas disponible.
- Unité de température de l’API Govee (thermomètres)Auto (par défaut) utilise d’abord l’unité de température que ton compte Govee indique pour l’appareil, puis convertit les thermomètres connus pour signaler des degrés Fahrenheit (par exemple H5179, H5109, H5110, H5111, H5053, H5075, H5100), et fait confiance aux autres. Choisis Fahrenheit si une valeur semble encore environ 1,8 fois trop élevée (par exemple 74 au lieu de 23), ou Celsius pour ne forcer aucune conversion. L’API de Govee omet les métadonnées d’unité, donc la valeur ne peut pas toujours être détectée automatiquement.
- Activer les appareils de groupeExpose les groupes d’appareils que tu as créés dans l’app Govee sous forme d’entités lumière uniques. Une commande envoyée à un groupe n’est émise qu’une fois et synchronisée avec tous les membres par le cloud de Govee, ce qui se synchronise mieux qu’un regroupement des lumières avec les assistants de Home Assistant. L’état est donné au mieux (les groupes ne peuvent pas être interrogés), et les lumières de groupe ne gèrent que l’alimentation, la luminosité et la couleur.
- Activer le sélecteur de scènesCrée une liste déroulante de scènes pour chaque appareil qui en a, et expose les scènes comme des effets de lumière. Désactive pour économiser une requête d’API par appareil au démarrage.
- Activer le sélecteur de scènes DIYCrée une liste déroulante de scènes DIY pour chaque appareil qui a des scènes DIY créées dans l’app Govee.
- Exposer les capteurs de connectivité par transport pour chaque appareilAjoute un capteur binaire de connectivité par transport (API cloud, MQTT, Bluetooth, réseau local) pour chaque appareil. Désactivé par défaut car cela crée quatre entités de diagnostic supplémentaires par appareil.
- Envoyer l’alimentation, la luminosité et la couleur par MQTT (plus rapide, expérimental)Fait passer les commandes d’alimentation, de luminosité et de couleur par le canal MQTT de Govee au lieu de l’API cloud REST, ce qui réduit la latence et contourne les limites de débit REST. Nécessite une connexion par e-mail et mot de passe (identifiants MQTT). Bascule automatiquement sur REST quand MQTT n’est pas disponible, et pour tout appareil qui n’a pas encore répondu par MQTT (il répond à la demande d’état périodique, donc garde-la activée). Expérimental : cela utilise un canal non documenté, donc laisse-le désactivé si les commandes se comportent de façon inattendue.
- Confirmer les commandes de lumière et renvoyer celles qui sont perduesAprès une commande d’extinction, de luminosité, de couleur ou de température de couleur envoyée à une lumière, attend quelques secondes le rapport en temps réel (AWS IoT) de la lumière et demande un état s’il n’en arrive aucun. Si la lumière affiche encore l’ancienne valeur, la commande est renvoyée une fois par l’API cloud. Lumières uniquement : les appareils comme les bouilloires, les radiateurs et les ventilateurs ne sont jamais renvoyés, et une commande d’allumage n’est jamais renvoyée. Un renvoi utilise une requête cloud, seulement si le budget quotidien et la limite de débit le permettent. Nécessite une connexion par e-mail et mot de passe ; les lumières qui n’ont pas fait de rapport via AWS IoT sont laissées telles quelles. Désactivé par défaut.
- Adresses et sous-réseaux des appareils en réseau local (avancé)
- Appareils à configurerAppareils pour lesquels définir un mode de segments. Les appareils que tu omets gardent leur mode actuel.
- Mode de segmentsDésactivé ne crée aucune entité de segment, groupé crée une entité pour tous les segments, individuel crée une entité par segment, et les deux crée l'entité groupée en plus des entités individuelles.
Textes issus du code de lasswellt/govee-homeassistant. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesConnectivité, API cloud, MQTT, Bluetooth, LAN, Réservoir d'eau plein, État de la pompe, Fuite d'eau, Présence, LoRa, Internet, Sonde supérieure et 4 autres
- BoutonsActualiser les scènes, Effacer l'alerte d'eau, Effacer l'alerte de fuite
- ÉvénementsBouton
- VentilateursVentilateur
- HumidificateursHumidificateur
- LumièresVeilleuse, Segments, Lumière principale
- NombresSensibilité musicale, Température cible
- SélecteursScène, Instantané, Scène DIY, Source HDMI, Mode musique, Vitesse du ventilateur, Mode, Scène de veilleuse
- CapteursLimite de débit API restante, État MQTT, Dernier message MQTT reçu, Température, Mode, Tension, Courant, Puissance, Énergie, Facteur de puissance, Température de la sonde 2, Humidité et 17 autres
- InterrupteursInterrogation en direct, Prise, Veilleuse, Mode musique, DreamView, Arrêt automatique, Alimentation, Lumière principale, Lumière d'arrière-plan, Lumière Nebula, Lumière Ripple, Lumière latérale et 3 autres
Actions
- Actualiser les scènesActualise les scènes disponibles depuis l'API Govee.Champs : Appareil
- Définir la couleur des segmentsDéfinit la couleur de segments précis sur une lumière RGBIC.Champs : Appareil, Segments, Couleur RVB
- Envoyer une trame ptReal bruteOutil de développement et de débogage qui envoie une trame de commande BLE Govee brute à l'appareil via AWS IoT (une somme de contrôle est ajoutée automatiquement quand 19 octets ou moins sont fournis). Une trame incorrecte peut laisser la lumière dans un mode inattendu.Champs : Appareil, Trame
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Le compte Govee nécessite une vérification, La connexion au compte Govee a expiré
Extrait du README
Control Govee lights, plugs, fans, humidifiers, heaters, thermometers, air‑quality & CO₂ monitors, presence & leak sensors — with optional real‑time push over Govee's AWS IoT MQTT and automatic local LAN control for devices that support it.
Hub (cloud) · IoT class cloud_push (MQTT + polling) · UI‑only config, no YAML
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Ventilateur, carte Bouton, Apple Watch, centre de contrôle.Informations
- Installations
- Non affichées : domaine partagé govee
- Étoiles GitHub
- 149
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2026.10.2,
- Catégorie
- Éclairage, Rubans LED et contrôleurs
- Type
- Intégration de la Marketplace
- Marque
- Govee
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
govee- Problèmes
- Signaler un problème












