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:
  • supports Govee OpenAPI discovery/state/control when an OpenAPI key is provided
  • requires your Govee credentials for most Cloud/AWS/BLE connections
  • can control certain models locally via LAN control without any Govee credentials
  • may use different connection methods depending on device model and account capabilities

Prerequisites

• To use this plugin, you will need to already have:
  • Node: latest version of v22, v24 or v26 - any other major version is not supported.
  • Homebridge: v1.6 or above - 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 on a Raspberry Pi, and has not been tested on Windows. macOS is newly supported from v11.32.2 and has only been tried on a handful of devices so far - you will need to give the node binary running Homebridge permission under System Settings → Privacy & Security → Bluetooth, and please do report anything that does not work.

Setup

• Installation
• Configuration
• Beta Version
• Node Version

Features

• Supported Devices
• Connection Methods
  • OpenAPI Control
  • 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.