pfeifferchsforks/govee2mqtt

Govee2MQTT: Connect Govee lights and devices to Home Assistant

Govee to MQTT bridge for Home Assistant

This repo provides a govee executable whose primary purpose is to act as a bridge between Govee devices and Home Assistant, via the Home Assistant MQTT Integration.

Features

• Robust LAN-first design. Not all of Govee's devices support LAN control, but for those that do, you'll have the lowest latency and ability to control them even when your primary internet connection is offline.
• Support for per-device modes and scenes.
• Support for the undocumented AWS IoT interface to your devices, provides low latency status updates.
• Support for the new Platform API in case the AWS IoT or LAN control is unavailable.

Feature	Requires	Notes
DIY Scenes	API Key	Find in the list of Effects for the light in Home Assistant
Music Modes	API Key	Find in the list of Effects for the light in Home Assistant
Tap-to-Run / One Click Scene	IoT	Find in the overall list of Scenes in Home Assistant, as well as under the Govee to MQTT device
Live Device Status Updates	LAN and/or IoT	Devices typically report most changes within a couple of seconds.
Segment Color	API Key	Find the Segment 00X light entities associated with your main light device in Home Assistant

• API Key means that you have applied for a key from Govee and have configured it for use in goovee2mqtt
• IoT means that you have configured your Govee account email and password for use in govee2mqtt, which will then attempt to use the undocumented and likely unsupported AWS MQTT-based IoT service
• LAN means that you have enabled the Govee LAN API on supported devices and that the LAN API protocol is functional on your network

Usage

• Installing the HASS Add-On - for HAOS and Supervised HASS users
• Running it in Docker
• Configuration

Have a question?

• Is my device supported?
• Check out the FAQ

Want to show your support or gratitude?

It takes significant effort to build, maintain and support users of software like this. If you can spare something to say thanks, it is appreciated!

• Sponsor me on Github
• Sponsor me on Patreon
• Sponsor me on Ko-Fi
• Sponsor me via liberapay

Credits

This work is based on my earlier work with Govee LAN Control.

The AWS IoT support was made possible by the work of @bwp91 in homebridge-govee.