Skip to content
Ben edited this page Sep 10, 2023 · 74 revisions

homebridge-govee

Homebridge plugin to integrate Govee devices into HomeKit

npm npm
verified-by-homebridge hoobs-certified
npm Discord

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

Features

Help/About

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.