Skip to content

Latest commit

 

History

History
69 lines (47 loc) · 1.54 KB

README.md

File metadata and controls

69 lines (47 loc) · 1.54 KB

pygovee

A Python wrapper for the HTTP Govee Developer API to control Govee WiFi supported devices. Developed by Shravan Prasanth (c) 2022. python os

Installation

pip3 install pygovee==1.0.2

or

pip install pygovee==1.0.2

Usage

**Retreive API Key from Govee Home App (Profile → About Us → Apply for API Key)

***10 requests per minute per device

from pygovee import Govee

client = Govee.GoveeClient(apiKey="<your api key>")
client.login()

Get Device List

**Mock MAC Address and Model, THIS DATA WON'T WORK!

client.get_device_list()
# Kitchen Lights: MAC_ADDRESS: 3E-C7-8A-95-A5-40, MODEL:: H6159
# Bedroom Lights: MAC_ADDRESS: 23-14-96-F0-0D-58, MODEL:: H6159

Replace <DEVICE_MAC_ADDRESS> and <DEVICE_MODEL> with your device information when running the command above.

Turn Devices On and Off

client.device_on("<DEVICE_MAC_ADDRESS>", "<DEVICE_MODEL>")
client.device_off("<DEVICE_MAC_ADDRESS>", "<DEVICE_MODEL>")

Change Device Brightness

brightness_level should be an int!

client.change_device_brightness(
	"<DEVICE_MAC_ADDRESS>", "<DEVICE_MODEL>", brightness_level
)

Change Device Color using R,G,B Values

r_value, g_value, b_value should all be an int!

client.change_device_color(
	"<DEVICE_MAC_ADDRESS>", "<DEVICE_MODEL>", r_value, g_value, b_value
)