Skip to content

Latest commit

 

History

History
93 lines (51 loc) · 2.96 KB

README.md

File metadata and controls

93 lines (51 loc) · 2.96 KB

Govee BLE Lighting Integration for HomeAssistant

Govee Logo

A powerful and seamless integration to control your Govee lighting devices via Govee API or BLE directly from HomeAssistant with full features support.


Table of Contents


Features

  • 🚀 Direct BLE Control: No need for middlewares or bridges. Connect and control your Govee devices directly through Bluetooth Low Energy.

  • ☁️ API Control: Supported all light devices with full features support including scenes!

  • 🌈 Scene Selection: Leverage the full potential of your Govee lights by choosing from all available scenes, transforming the ambiance of your room instantly.

  • 💡 Comprehensive Lighting Control: Adjust brightness, change colors, or switch on/off with ease.


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.

For Govee API Control:

  • Retrieve Govee-API-Key as described here, setup integration with API type ad fill your API key.

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.


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 selected correct device model.

  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 of this repository.

  • Device support:

    Almost every Govee device has its own BLE message protocol. If you have an Android smartphone and your device is not supported, please contact me on Telegram.

  • Contributions:

    We welcome community contributions! If you'd like to improve the integration or add new features, please fork the repository and submit a pull request.


Future Plans

We aim to continuously improve this integration by:

  • Supporting more Govee device models for BLE
  • Enhancing the overall user experience and stability

License

This project is under the MIT License. For full license details, please refer to the LICENSE file in this repository.