mirror of https://github.com/jnstockley/Govee-Hassio.git synced 2026-06-05 17:47:55 -05:00

Govee Integration for Home Assistant

Python 97.8%
Shell 2.2%

Find a file

Jack Stockley 207549dc4c Merge pull request #95 from jnstockley/dev Update softprops/action-gh-release action to v3		2026-04-13 10:42:20 -05:00
.github	Update softprops/action-gh-release action to v3	2026-04-12 05:05:57 +00:00
custom_components/govee	Bump version number	2025-05-16 15:13:38 -05:00
scripts	Remove lint	2024-11-15 19:42:23 -06:00
.gitignore	first commit	2023-12-27 14:29:03 -06:00
.python-version	Update python Docker tag to v3.14	2025-10-07 22:14:48 +00:00
.ruff.toml	Fix setup error	2025-05-14 17:00:21 -05:00
hacs.json	Updating hacs.json file	2024-11-15 20:04:55 -06:00
README.md	Setting up repo for hacs	2024-11-15 19:36:52 -06:00
renovate.json	Migrate config renovate.json	2025-08-06 00:01:29 +00:00
requirements.txt	Update govee-cloud	2025-05-16 13:48:59 -05:00
requirements_dev.txt	Fix ruff check issues	2025-05-14 16:12:27 -05:00

README.md

Govee Home Assistant Integration

This is a custom integration for Home Assistant that allows you to integrate your Govee devices into Home Assistant. This integration uses the Govee API to communicate with your devices.

Setup

Install Hacs
Add this repository as a custom repository in Hacs: https://github.com/jnstockley/Govee-Hassio
Install the Govee integration from Hacs
Add configuration to your configuration.yaml file
Restart Home Assistant

Example Configuration

# Fan Example
fan:
  - platform: govee
    device_id: <Device ID>
    api_key: <Govee API Key>
    name: <Device SKU>
  - platform: govee
    device_id: <Device ID>
    api_key: <Govee API Key>
    name: <Device SKU>
# Thermometer Example
senor:
  - platform: govee
    device_id: <Device ID>
    api_key: <Govee API Key>
    name: <Device SKU>

Get Device ID

Make an HTTP GET Request to https://openapi.api.govee.com/router/api/v1/user/devices
Make sure to include the Govee-API-Key header with your Govee API Key
The device value is your device ID
The sku is the device SKU, used in the name configuration

Supported Devices

Wi-Fi Thermometer (H5179)
Wi-Fi Smart Tower Fan (H7102)
W-Fi Smart Air Purifier (H7126) (WiP)