Skip to content
/ govee2mqtt Public

Govee2MQTT: Connect Govee lights and devices to Home Assistant

License

Notifications You must be signed in to change notification settings

wez/govee2mqtt

Repository files navigation

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

Have a question?

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!

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.