kailan / homebridge-govee

Homebridge plugin to integrate Govee devices into HomeKit.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

homebridge-govee

Homebridge plugin to integrate Govee devices into HomeKit

verified-by-homebridge hoobs-certified
npm npm
npm JavaScript Style Guide
Discord 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 AWS/BLE connections
    • requires your Govee API key for certain light models
    • can control certain models locally via LAN control without any Govee credentials

Prerequisites

  • To use this plugin, you will need to already have Homebridge (at least v1.4) or HOOBS (at least v4.2) installed. Refer to the links for more information and installation instructions.
  • The plugin supports Node v14, v16 (recommended) and v18 as per the Homebridge plugin guidelines.
  • 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.

About

Homebridge plugin to integrate Govee devices into HomeKit.

License:MIT License


Languages

Language:JavaScript 95.4%Language:HTML 4.6%