Official app for the Govee WIFI enabled devices. This app supports the main light functions as they are available in the Govee API.
Getting started
For Lights (using the cloud API) and the Appliances:
You need to use the Govee app to request the API key for you account.
Then after installing this app you can set the API key in the app settings.
Use the test API tab to validate that it works and you get your devices returned.
Then you can add the Govee devices.
For local Api devices ensure you enable local API on every device you want to use like this. It also requires access to UDP port 4002 on your host (Homey Pro or self hosted). Use the loca API tab to validate that this port got estebslihed and see what devices are discovered.
Check if your device is supported here, but testing is better (Govee creates many new devices and they dont update this page a lot):
Supported Product Models (govee.com)
Supported Govee devices
Currently the app supports the:
- Cloud api enabled lights
- Cloud api enabled Appliances
- Local api enabled devices (only lights I beleive)
- Matter enabled devices, capabilities are limited to the matter standard.
Cloud API devices (main release)
The Govee API v2 allows most normal operations, these are:
- Allows for Light scene control (Flow and optional UI)
- Allows for DIY Light scene control (Flow and optional UI)
- Allows for activation of snapshots (Flow)
- Allows for control of segments (Flow)
- Allows for activating the Musicmode (Flow)
- Allows for activating DreamView (Flow and optional UI)
For the different modes it right now is not possible to know in what mode the device is, so status might get out of sync (like the dreamview mode) - All devices now have an Online alarm support
- Local devices can now be enabled to enhance the device with the advanced features through the cloud (hybrid), see device advanced settings to enable it for a given device
Local API devices
- The local API devices are much fast in response and dont require cloud support
- The local API devices will not impact your API throttle limits from Govee, so really helps to solve those kind of issues.
- The local API devices seem to allow you to add the same light multiple times. These could cause troubles, so I advise against doing it.
- Local API devices dont know their name, or they dont expose them, so you only get the device type. You can enable/disable local api support on devices to add them on by one.
- Local API devices require discovery time, after the app starts/restarts it may take a minute or so before all devices are discovered and available (wont be ‘solved’)
- Local API devices wont receive updates on colortemp changes (they do when you swicth to colortemp mode) made by other apps like the Govee mobile/light app etc, all other updates should be handled really quickly (needs an 3rd party fix)
- You can enhance local API devices by setting your cloud api key in the app settngs and enable the setting on each device. This allows for the other operations to be available using the cloud api.
If you experience Local API troubles, there is a Local API tab in the app settings. Look at it and ensure the UDP host is connected. If it is not there is an error output below. Mostly this means your host system (Homey Pro or self hosted) is not allowing the UDP to be connected by the app. In the case of Homey Pro this is mostly because another app is using it already.
Appliances
- Appliance support has split into more dedicated appliances, since version 2.9 these use the new Homey device classes
- Thermometer/Hydrometer is fully supported
- Humidifier is fully support (On/Off, nightlight toggle/mode, work mode (through flow), lack water event)
- Ice maker now also supports the lack water event
- Sensors that support the presence event should now also receive these events.
- Other devicee classes might work fully but are untested by me, please provide feedback
If you own an appliance that is of the other classes (like heaters, ice makers, sensors, fan, etc) that you think should support more events or capabilities, please send me a PM. In the app settings you find a API Test tab, navigate to it and retieve the device list. Once successfull you can copy the raw output and send this in the PM, this will help me discover what is needed.
I wont reply to these questions without this data.
And its available now:
Test channel
- Test channel is now in sync with main*
Device support questions
I have no control on devices supported, that is done on API side by Govee.
The list they publish is also not maintained so it is best to try.
If it shows up, it is supported, if you add it and then have missing features you think they api would support I can see if it is.
If it doesnt even show up, then its not supported or not linked to your govee account that generated the API key.
