{"id":13585075,"url":"https://github.com/LaggAt/hacs-govee","last_synced_at":"2025-04-07T06:32:26.306Z","repository":{"id":37249926,"uuid":"312080478","full_name":"LaggAt/hacs-govee","owner":"LaggAt","description":"A HACS repository for Govee light integration","archived":false,"fork":false,"pushed_at":"2025-01-10T06:56:39.000Z","size":1500,"stargazers_count":296,"open_issues_count":134,"forks_count":71,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-03T06:09:03.264Z","etag":null,"topics":["devcontainer","govee","hacs","home-assistant","light","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LaggAt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-11T20:20:34.000Z","updated_at":"2025-04-01T03:25:31.000Z","dependencies_parsed_at":"2023-11-12T12:32:20.534Z","dependency_job_id":"26c52a84-87f8-449d-884d-20adc6220cb4","html_url":"https://github.com/LaggAt/hacs-govee","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaggAt%2Fhacs-govee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaggAt%2Fhacs-govee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaggAt%2Fhacs-govee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaggAt%2Fhacs-govee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LaggAt","download_url":"https://codeload.github.com/LaggAt/hacs-govee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247607305,"owners_count":20965942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devcontainer","govee","hacs","home-assistant","light","python"],"created_at":"2024-08-01T15:04:43.720Z","updated_at":"2025-04-07T06:32:26.299Z","avatar_url":"https://github.com/LaggAt.png","language":"Python","funding_links":["https://www.buymeacoffee.com/LaggAt"],"categories":["Python","Custom Integrations"],"sub_categories":["💡 Lighting"],"readme":"# 'Govee' integration\n\nThe Govee integration allows you to control and monitor lights and switches using the Govee API.\n\n## Installation\n\n* The installation is done inside [HACS](https://hacs.xyz/) (Home Assistant Community Store). If you don't have HACS, you must install it before adding this integration. [Installation instructions here.](https://hacs.xyz/docs/setup/download)\n* Once HACS is installed, navigate to the 'Integrations' tab in HACS and search for the 'Govee' integration there. Click \"Download this repository in HACS\". On the next screen, select \"Download\". Once fully downloaded, restart HomeAssistant.\n* In the sidebar, click 'Configuration', then 'Devices \u0026 Services'. Click the + icon to add \"Govee\" to your Home Assistant installation. An API key\nis required, you need to obtain it in the 'Govee Home' app on your mobile device. This can be done from the Account Page (Far right icon at the bottom) \u003e Settings (top right icon) \u003e About Us \u003e Apply for API Key. The key will be sent to your account email.\n\n## Sponsor\n\nA lot of effort is going into that integration. So if you can afford it and want to support us:\n\n\u003ca href=\"https://www.buymeacoffee.com/LaggAt\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\nThank you!\n\n## Is it stable?\n\nWe think so. It is used often, and the support thread is active.\n\n![usage statistics per version](https://raw.githubusercontent.com/LaggAt/actions/main/output/goveestats_installations.png)\n\nUsage Data is taken from Home Assistant analytics, and plotted over time by us. You need to enable analytics if you want to show here.\n\n## Is there an issue right now?\n\nThis 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.\n\n![Govee API running?](https://raw.githubusercontent.com/LaggAt/actions/main/output/govee-api-up.png)\n\n## Pulling or assuming state\n\nSome devices do not support pulling state. In this case we assume the state on your last input.\nFor others, we assume the state just after controlling the light, but will otherwise request it from the cloud API.\n\n## DISABLING state updates for specific attributes\n\nYou 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.\n\nNot all attribute updates can be disabled, but most can. Fiddling here could also lead to other misbehavours, but it could help with some issues.\n\nLet's talk about an example:\n\n### What if power_state isn't correctly returned from API?\n\nWe 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.\n\n![two-button-state](https://community-assets.home-assistant.io/original/3X/d/7/d7d2ee09520672e7671fdeed5bb461fcfaab8493.png)\n\nSo 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:\n\n1. 'API' or 'History': state from which source do we want to disable? In our example the API state is wrong, as we could see in logs, so we choose 'API'\n2. Look up the attribute you want to disable in GoveeDevice data class. Don't worry, you don't need to understand any of the code here. [Here is that data class (click)](https://github.com/LaggAt/python-govee-api/blob/master/govee_api_laggat/govee_dtos.py). In our Example we will find 'power_state'\n3. Next, in Home Assistant we open Configuration - Integrations and click on the options on the Govee integration. Here is an example how this config option could look:\n\n![DISABLE state updates option](https://community-assets.home-assistant.io/original/3X/6/c/6cffe0de8b100ef4efc0e460482ff659b8f9444c.png)\n\n4. With the information from 1. and 2. we could write a string disabling power_state from API. This will do the trick for our case:\n```\nAPI:power_state\n```\n\nIF you want to disable a state from both sources, do that separately. You may have as many disables as you like.\n```\nAPI:online;HISTORY:online\n```\n\n[If you fix an issue like that, consider helping other users on the forum thread (click).](https://community.home-assistant.io/t/govee-integration/228516/438?u=laggat)\n\nALWAYS REMEMBER: this should always be a temporarly workaround, if you use it in daily business you should probably request a feature or bug fix :)\n\nTo remind you disabling it asap, this wil log a warning on every update.\n\n## What is config/govee_learning.yaml\n\nUsually you don't have to do anything here - just in case something feels wrong read on:\n\n```\n40:83:FF:FF:FF:FF:FF:FF:\n  set_brightness_max: 100\n  get_brightness_max: 100\n  before_set_brightness_turn_on: false\n  config_offline_is_off: false\n```\n\nDifferent Govee devices use different settings. These will be learned by the used library, or can be configured by you.\n\n* set_brightness_max: is autolearned, defines the range to set the brightness to 0-100 or 0-254.\n* get_brightness_max: is autolearned, defines the range how to interpet brightness state (also 0-100 or 0-254).\n* before_set_brightness_turn_on: Configurable by you, default false. When true, if the device is off and you set the brightness \u003e 0 the device is turned on first, then after a second the brightness is set. Some device don't turn on with the set brightness command.\n* config_offline_is_off: Configurable by you, default false. This is useful if your device is e.g. powered by a TV's USB port, where when the TV is off, the LED is also off. Usually we stay in the state we know, this changes this to OFF state when the device disconnects.\n\n## Support\n\nSupport thread is here: \u003chttps://community.home-assistant.io/t/govee-led-strips-integration/228516\u003e\nThere you'll also find links to code repositories and their issue trackers.\n\nFor bug reports, include the debug log, which can be enabled in configuration YAML + restart:\n\n```YAML\nlogger:\n  default: warning\n  logs:\n    homeassistant.components.govee: debug\n    custom_components.govee: debug\n    govee_api_laggat: debug\n```\n\nThen in Settings - Logs click on “full logs” button and add them to the bug report after removing personal data.\n\n## Caveats\n\nYou 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.\nIf you have more than one lamp use a higher interval. Govee wants to implement a single request for all devices in 2021.\n\nOnce the integration is active, you will see all your registered devices, and may control on/off, brightness, color temperature and color.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLaggAt%2Fhacs-govee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLaggAt%2Fhacs-govee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLaggAt%2Fhacs-govee/lists"}