Skip to content

Homebridge plugin to integrate Govee devices into HomeKit.

License

Notifications You must be signed in to change notification settings

homebridge-plugins/homebridge-govee

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Oct 28, 2020
3302b5d · Oct 28, 2020
Oct 23, 2020
Oct 28, 2020
Sep 29, 2020
Sep 29, 2020
Sep 16, 2020
Oct 23, 2020
Oct 24, 2020
Oct 17, 2020
Oct 28, 2020
Oct 28, 2020

Repository files navigation

homebridge-govee

Homebridge/HOOBS plugin to control Govee devices that are supported by the official Govee API.

verified-by-homebridge hoobs-certified
npm npm
npm JavaScript Style Guide
Discord

Prerequisites

To use this plugin, you will need to already have Homebridge or HOOBS installed. Please refer to the links for more information and installation instructions.

Plugin Information

This plugin uses the official Govee HTTP API to enable you to control supported Govee devices through Homebridge.

⚠️ Your devices will need have a stable connection to your Wi-Fi as this plugin uses the internet to control your devices. This plugin does not use a Bluetooth connection to control your devices.

⚠️ There are some light modes in which the plugin is unable to determine the current state and/or control your device. If you experience any issues then please enable "Debug Logging" from the plugin settings and useful information will be added to the Homebridge logs.

That said, in most situations this plugin allows you to control:

  • On/Off state
  • Brightness
  • Colour

For the following Govee models:

  • H50**
    • H5081
  • H60**
    • H6002, H6003, H6083, H6085, H6086, H6089
  • H61**
    • H6104, H6109, H6110, H6117, H6135, H6137, H6141, H6142, H6148, H6159, H6160, H6163, H6182, H6188, H6195, H6196
  • H70**
    • H7005, H7014, H7021, H7022

You will need to retrieve an API key which you can obtain through the Govee mobile app.

  • Go to your account tab → "About us" → "Apply for API key"
  • Fill out your name and your reason - I'm sure "Control through Homebridge" would be sufficient
  • You'll receive your API key to your Govee registered email address normally within minutes

The plugin is limited to the current functionality of the Govee API. I will continue to implement new features to the plugin as the Govee API is updated.

Setup

About

Disclaimer

I am in no way affiliated with Govee and this plugin is a personal project that I maintain in my free time.