Your Govee lights + Home Assistant = RGB bliss with real-time control
Ever wanted your Govee lights to actually talk to Home Assistant? This integration gives you:
- Full light control — brightness, RGB colors, color temp, the works
- Scene magic — your Govee scenes become HA scenes
- RGBIC segment control — paint each segment a different color
- Real-time sync — optional MQTT for instant updates (bye-bye polling lag)
In the Govee Home app: Profile → Settings → Apply for API Key
Check your email in ~5 minutes.
Click the button above, search "Govee", hit Download, restart Home Assistant.
Settings → Devices & Services → Add Integration → Govee
Enter your API key. Want instant updates? Add your Govee email/password for MQTT.
| Device | Features |
|---|---|
| LED Lights & Strips | On/off, brightness, RGB, color temp |
| RGBIC Strips | All the above + per-segment colors |
| Fans | On/off, speed (Low/Medium/High), oscillation, preset modes |
| HDMI Sync Boxes | On/off, HDMI input selection (1-4) |
Note: Cloud-enabled devices only. Bluetooth-only devices need a different integration.
Polling is so 2020. Add your Govee account credentials during setup for instant state sync via AWS IoT MQTT.
No credentials? Polling works fine (every 60 seconds by default).
| Problem | Fix |
|---|---|
| Devices not showing | Make sure they're WiFi devices, not Bluetooth-only |
| Slow updates | Enable MQTT or reduce poll interval in options |
| Rate limit errors | Increase poll interval (Govee allows 100 req/min) |
When troubleshooting issues, enable debug logging to capture detailed information about what the integration is doing.
Option 1: From the Integration (Recommended)
- Go to Settings → Devices & Services
- Find the Govee integration card
- Click the three dots menu (⋮) on the integration card
- Select Enable debug logging
- Reproduce the issue (turn on a light, trigger the error, etc.)
- Return to the integration card, click the three dots menu again
- Select Disable debug logging
- Your browser will download a log file automatically
Option 2: Via configuration.yaml
For issues during startup or if you need persistent debug logging, add to your configuration.yaml and restart:
logger:
default: info
logs:
custom_components.govee: debug- Go to Settings → System → Logs
- Click Load Full Logs to see everything
- Use the search box to filter for "govee"
See Home Assistant Logger docs for more details.
When opening an issue, include relevant log entries. Here's what to capture:
- Enable debug logging (see above)
- Reproduce the issue (turn on/off a device, change a scene, etc.)
- Copy the relevant log entries
What to include:
- Logs from when Home Assistant starts (shows device discovery)
- Logs from when the issue occurs
- Any error messages or tracebacks
Example log snippet to include:
2024-01-15 10:30:45 DEBUG (MainThread) [custom_components.govee.coordinator] Device: Living Room Light (AA:BB:CC:DD:EE:FF:00:11) type=devices.types.light
2024-01-15 10:30:45 DEBUG (MainThread) [custom_components.govee.coordinator] Capability: type=devices.capabilities.on_off instance=powerSwitch
Before posting, redact sensitive information:
- Replace device IDs with
XX:XX:XX:XX:XX:XX:XX:XX - Remove any email addresses or account IDs
When reporting issues with unsupported devices or unexpected behavior, please include your device's API response. This helps us understand your device's capabilities and fix the problem.
You'll need your Govee API key (the same one you used to set up this integration).
Step 1: Open Terminal
- macOS: Press
Cmd + Space, type "Terminal", press Enter - Linux: Press
Ctrl + Alt + Tor search for "Terminal" in your applications
Step 2: Get your device list
Copy this command, replace YOUR_API_KEY with your actual API key, then paste into Terminal and press Enter:
curl -s -H "Govee-API-Key: YOUR_API_KEY" "https://openapi.api.govee.com/router/api/v1/user/devices"Step 3: Get device state (optional, for more details)
From the output above, find your device's sku (e.g., "H7101") and device ID (e.g., "AA:BB:CC:DD:EE:FF:00:11"), then run:
curl -s -X POST -H "Govee-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"requestId":"test","payload":{"sku":"YOUR_SKU","device":"YOUR_DEVICE_ID"}}' "https://openapi.api.govee.com/router/api/v1/device/state"Step 1: Open PowerShell
- Press
Win + X, then click "Windows PowerShell" or "Terminal" - Or press
Win + R, typepowershell, press Enter
Step 2: Get your device list
Copy this command, replace YOUR_API_KEY with your actual API key, then paste into PowerShell and press Enter:
Invoke-RestMethod -Uri "https://openapi.api.govee.com/router/api/v1/user/devices" -Headers @{"Govee-API-Key"="YOUR_API_KEY"} | ConvertTo-Json -Depth 10Step 3: Get device state (optional, for more details)
From the output above, find your device's sku and device ID, then run (replace the values):
Invoke-RestMethod -Uri "https://openapi.api.govee.com/router/api/v1/device/state" -Method POST -Headers @{"Govee-API-Key"="YOUR_API_KEY"; "Content-Type"="application/json"} -Body '{"requestId":"test","payload":{"sku":"YOUR_SKU","device":"YOUR_DEVICE_ID"}}' | ConvertTo-Json -Depth 10Before posting, redact sensitive information:
- Replace your API key with
REDACTED - Replace your email/account ID if visible
Then paste the output in your GitHub issue.
PRs welcome! See CONTRIBUTING.md.
MIT — see LICENSE.txt