@homebridge-plugins/homebridge-govee
v11.37.0
Published
Homebridge plugin to integrate Govee devices into HomeKit.
Readme
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,v24orv26- any other major version is not supported. - Homebridge:
v1.6or 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.2and has only been tried on a handful of devices so far - you will need to give thenodebinary running Homebridge permission under System Settings → Privacy & Security → Bluetooth, and please do report anything that does not work.
- Node: latest version of
Setup
Features
- Supported Devices
- Connection Methods
- OpenAPI Control
- LAN Control
- AWS Control
- BLE Control
- Scene, Music, DIY Modes
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.
