Govee API

https://img.shields.io/pypi/status/govee_api?label=PyPi https://img.shields.io/travis/thomasreiser/govee_api https://readthedocs.org/projects/govee_api/badge/?version=latest https://pyup.io/repos/github/thomasreiser/govee_api/shield.svg

Simple and minimal Govee Home API client to control Govee smart devices.

pip install -r requirements_dev.txt

Message to Govee

We all love your products but unfortunately there is no public API. Thus, we cannot control the devices we have purchased in our own smart home environments. I have created this library so that I can control my devices easily without the Govee app and to help others doing this. Nobody wants to harm you, your server infrastructure or anything or anybody else. In case you cannot accept my code to be public, please send me an e-mail to reiser.thomas@gmail.com and I will immediately shut down this repository and will delete all artifacts from PyPi.

Features

  • Control Govee IOT smart devices (Bulbs, LED strips)

Approved device support

Device SKU Approved since
Bulbs
H6001 2.0.0
LED strips
H6113 2.0.0
H6159 1.0.0
H6163 1.0.0
String lights
-none yet-

Please test your own devices with the API and tell me the results! In case something did not work, please provide me the RAW JSON data received via the new device + device update events.

Not yet implemented

  • String light support
  • Bluetooth-only color modes (Music, Scene, DIY)
  • Bluetooth events sent from devices (are there any?)

Usage

See docs/usage.rst or testclient.py