/govee_ble_lights

Govee BLE Lighting Integration for HomeAssistant

Primary LanguagePythonMIT LicenseMIT

Govee BLE Lighting Integration for HomeAssistant

Govee Logo

A powerful and seamless integration to control your Govee lighting devices via 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.

  • 🌈 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

Permissions

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.

Troubleshooting

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
  • Adding more granular control features
  • Enhancing the overall user experience and stability

Tips

If you wish to support the development of the project and prioritize the addition of your device model, you can support me:

Don't forget to leave a message in Telegram and your device model.

License

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