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.
- 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 Keymeans that you have applied for a key from Govee and have configured it for use in goovee2mqttIoTmeans 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 serviceLANmeans that you have enabled the Govee LAN API on supported devices and that the LAN API protocol is functional on your network
- Installing the HASS Add-On - for HAOS and Supervised HASS users
- Running it in Docker
- Configuration
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!
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.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
