Skip to content

Repository files navigation

Plugin Logo

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

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.

About

Homebridge plugin to integrate Govee devices into HomeKit.

Topics

Resources

Contributing

Security policy

Stars

590 stars

Watchers

13 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages