https://github.com/virtuald/govee-ble-plugs
Control your Govee Smart Plugs via BLE directly from HomeAssistant
https://github.com/virtuald/govee-ble-plugs
govee hacs homeassistant-integration smart-plugs
Last synced: 11 months ago
JSON representation
Control your Govee Smart Plugs via BLE directly from HomeAssistant
- Host: GitHub
- URL: https://github.com/virtuald/govee-ble-plugs
- Owner: virtuald
- License: apache-2.0
- Created: 2024-12-21T22:43:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-17T04:42:32.000Z (about 1 year ago)
- Last Synced: 2025-06-03T14:55:30.681Z (about 1 year ago)
- Topics: govee, hacs, homeassistant-integration, smart-plugs
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Govee BLE Smart Plug Integration for HomeAssistant
Control your Govee Smart Plugs via BLE directly from HomeAssistant!
## Features
- 🚀 **Direct BLE Control**: No need for middlewares or bridges. Connect and control your Govee devices directly through Bluetooth Low Energy.
Supported devices:
* H5080 Smart Plug
* H5082 Dual Smart Plug
## Configuration
### What is needed
For Direct BLE Control:
- Before you begin, make certain HomeAssistant can access BLE on your platform. Ensure your HomeAssistant instance is granted permissions to utilize the Bluetooth Low Energy of your host machine.
## Usage
With the integration setup, your Govee devices will appear as entities within HomeAssistant. All you need to do is select your device model when adding it.
## Installation
* 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)
* At the present moment this integration has not been published to HACS, but you can still install it as a custom integration. See https://www.hacs.xyz/docs/faq/custom_repositories/ for details
## Troubleshooting for BLE
If you're facing issues with the integration, consider the following steps:
1. **Check BLE Connection**:
Ensure that the Govee device is within the Bluetooth range of your HomeAssistant host machine.
2. **Model Check**:
Check that you are using a supported device
3. **Logs**:
HomeAssistant logs can provide insights into any issues. Navigate to `Configuration > Logs` to review any error messages related to the Govee integration.
---
## Support & Contribution
- **Found an Issue?**
Raise it in the [Issues section](https://github.com/virtuald/govee_ble_plugs/issues) of this repository.
- **Device support**:
I do not plan to add support for devices that I do not own, but I'm happy to accept support for new devices.
- **Contributions**:
I am happy to accept contributions to improve this integration or add new local-only devices. I will not accept cloud-based integrations.
Credit
------
H5080 support would not have been possible without the scripts from https://github.com/egold555/Govee-Reverse-Engineering (and if you want to add support for more devices then this is a good place to start!).
This integration was inspired by https://github.com/Beshelmek/govee_ble_lights/ and I started writing this based on its code, but I eventually just copied a bunch of code from the [keymitt_ble integration](https://github.com/home-assistant/core/tree/dev/homeassistant/components/keymitt_ble) since it was much closer to what actually needed to be accomplished.
This integration is available under the Apache 2.0 license.