A HACS repository for Govee light integration
The Govee integration allows you to control and monitor lights and switches using the Govee API.
A lot of effort is going into that integration. So if you can afford it and want to support us:
Thank you!
We think so. It is used often, and the support thread is active.
Usage Data is taken from Home Assistant analytics, and plotted over time by us. You need to enable analytics if you want to show here.
This graph uses the same library to do simple checks. If you see round dots on the right of the graph (= today), probably there is an issue.
Some devices do not support pulling state. In this case we assume the state on your last input. For others, we assume the state just after controlling the light, but will otherwise request it from the cloud API.
You shouldn't use this feature in normal operation, but if something is broke e.g. on Govee API you could help yourself and others on the forum with a little tweak.
Not all attribute updates can be disabled, but most can. Fiddling here could also lead to other misbehavours, but it could help with some issues.
Let's talk about an example:
We can have state from two sources: 'API' and 'HISTORY'. History for example means, when we turn on a light we already guess the state will be on, so we set a history state of on before we get data from the API. In the default configuration you could also see this, as it shows two buttons until the final state from API arrives.
So let's say we have an issue, that the ON/OFF state from API is wrong, we always get OFF. (This happended, and this is why I developed that feature). If we disable the power state we get from API we could work around this, and thats exactly what we do:
API:power_state
IF you want to disable a state from both sources, do that separately. You may have as many disables as you like.
API:online;HISTORY:online
If you fix an issue like that, consider helping other users on the forum thread (click).
ALWAYS REMEMBER: this should always be a temporarly workaround, if you use it in daily business you should probably request a feature or bug fix :)
To remind you disabling it asap, this wil log a warning on every update.
Usually you don't have to do anything here - just in case something feels wrong read on:
40:83:FF:FF:FF:FF:FF:FF:
set_brightness_max: 100
get_brightness_max: 100
before_set_brightness_turn_on: false
config_offline_is_off: false
Different Govee devices use different settings. These will be learned by the used library, or can be configured by you.
Support thread is here: https://community.home-assistant.io/t/govee-led-strips-integration/228516 There you'll also find links to code repositories and their issue trackers.
For bug reports, include the debug log, which can be enabled in configuration YAML + restart:
logger:
default: warning
logs:
homeassistant.components.govee: debug
custom_components.govee: debug
govee_api_laggat: debug
Then in Settings - Logs click on “full logs” button and add them to the bug report after removing personal data.
You can set a poll interval, but don't set it too low as the API has a limit of 60 requests per minute, and each device needs one request per state pull and control action. If you have more than one lamp use a higher interval. Govee wants to implement a single request for all devices in 2021.
Once the integration is active, you will see all your registered devices, and may control on/off, brightness, color temperature and color.