README.md

homebridge-govee

Homebridge plugin to integrate Govee devices into HomeKit

Plugin Information

• This plugin allows you to view and control your Govee devices within HomeKit. The plugin:
  • requires your Govee credentials for most device models and Cloud/BLE connections
  • can control certain models locally via LAN control without any Govee credentials
  • does not make use of the Govee API key

Prerequisites

• To use this plugin, you will need to already have:
  • Node: latest version of v18 or v20 - any other major version is not supported.
  • Homebridge: v1.6 - refer to link for more information and installation instructions.
  • For bluetooth connectivity, it may be necessary to install extra packages on your system, see Bluetooth Control. Bluetooth works best when using a Raspberry Pi, not been tested on Windows, and Mac devices are unsupported.

Setup

• Installation
• Configuration
• Beta Version
• Node Version

Features

• Supported Devices
• Connection Methods
  • LAN Control
  • AWS Control
  • BLE Control
• Scene, Music, DIY Modes

Help/About

• Common Errors
• Support Request
• Changelog
• About Me

Credits

• To all users who have shared their devices to enable functionality.
• To the creator/owner of the govee-led-client library which made the BLE connection possible.
• To the creator/owner of the govee_api library which made the AWS connection possible.
• To @alboiuvlad29 who made the LAN connection possible.
• To @JeremyDunn for his code from homebridge-govee-water-detectors for leak sensor support.
• To the creator/owner of the govee-bt-client library which made the BLE connection to sensors possible.
• To the creator of the awesome plugin header logo: Keryan Belahcene.
• To the creators/contributors of Homebridge who make this plugin possible.

Disclaimer

• I am in no way affiliated with Govee and this plugin is a personal project that I maintain in my free time.
• Use this plugin entirely at your own risk - please see licence for more information.