Skip to content

Config and Option Flow for Govee Light Local #38148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: next
Choose a base branch
from
Open

Config and Option Flow for Govee Light Local #38148

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e7969f8
Update govee lights local docs
Galorhallen Mar 16, 2025
666099d
Format
Galorhallen Mar 23, 2025
35bc115
Merge branch 'next' into govee-manual-ip
Galorhallen Mar 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 31 additions & 1 deletion source/_integrations/govee_light_local.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,39 @@ Integrates [Govee](https://www.govee.com/) lights into Home Assistant using Loca
To enable local control on your Govee device, refer to the instructions available [here](https://app-h5.govee.com/user-manual/wlan-guide).

{% include integrations/config_flow.md %}
{% configuration_basic %}
Enabled auto discovery:
description: When auto discovery is enabled, the integration will search for devices on your local network. If no devices are found within a specified timeout period, the configuration process will abort. If you disable auto discovery during setup, the integration will be created without any devices.
{% endconfiguration_basic %}

{% include integrations/option_flow.md %}
{% configuration_basic %}
Add device:
description: Manually add a Govee device by entering its IP address. The device will then be queried using unicast messages.
Remove devices:
description: Remove one or more manually added devices from the integration. A dropdown menu displays devices that have been manually added to the integration.
Configure auto discovery:
description: Adjust the auto discovery setting post-setup. You can enable or disable automatic detection of devices on your local network.
{% endconfiguration_basic %}

## Troubleshooting

- If the integration fails to start with the message `Port 4002 already in use` you should check if another integration or software is using the port.\
To do so, you can run in a SSH terminal the command (preferably as `root`):

```bash
netstat -anoup | grep ":4002"
```

that show which programme is currently using the port `4002`.

- If a device is not automatically discovered, try to configure it manually by entering its IP address.

## Supported devices

There is a list of currently supported devices. If a device is not listed here it should still be picked up by autodiscovery (if it has the LAN control enabled) with only on/off functionality.\
To get it added to the integration, open an issue at the [underlying library](https://github.com/Galorhallen/govee-local-api/issues) using the appropriate issue template.

H6008,
H600D,
H6022,
Expand Down Expand Up @@ -154,5 +184,5 @@ H805C,
H8072

{% note %}
Some scenes may not be supported from all devices. If you find a scene that's not working with a specific model, please open an issue at the [underling library](https://github.com/Galorhallen/govee-local-api/issues)
Some scenes may not be supported from all devices. If you find a scene that's not working with a specific model, please open an issue at the [underlying library](https://github.com/Galorhallen/govee-local-api/issues)
{% endnote %}