Installation

0. Install Bluetooth Packages

This step is required if you wish to control your devices via bluetooth. The plugin uses the noble bluetooth package which requires extra packages to be installed on your system for it to work.

If you already have the plugin installed, follow the instructions below then reinstall the plugin via the Homebridge/HOOBS UI.

Homebridge RPi Image

Run these commands in the Homebridge terminal:

sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev

sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)

Then restart Homebridge.

Other Systems

See the noble documentation for instructions specific to your system.

1. Install

Homebridge UI & HOOBS

Simply go to the 'Plugins' page, search homebridge-govee and click 'Install'.

Manually

This will only work if you are using a platform which installs plugins globally.

sudo npm i homebridge-govee -g

2. Configure

If you use the Homebridge UI or HOOBS then a configuration screen will appear after installing the plugin where you can enter your Govee API key.

See the Configuration page for JSON configuration templates and other optional settings if editing the configuration manually.

3. Restart

And voila your supported Govee devices should be added to your Homebridge/HOOBS instance.