govee-lights

name	govee-lights
description	Control Govee smart lights via the Govee API. Supports turning lights on/off, adjusting brightness, setting colors, and scenes. Use for: (1) Controlling individual lights or groups by name, (2) Setting colors and brightness, (3) Managing device states

Govee Lights Control

Control Govee smart lights using natural language commands.

Quick Reference

Command	Example
List devices	python3 scripts/govee.py list
Turn on	python3 scripts/govee.py on "lamp"
Turn off	python3 scripts/govee.py off "lamp"
Brightness	python3 scripts/govee.py brightness "lamp" 75
Color	python3 scripts/govee.py color "lamp" 255 100 50

Natural Language Patterns

• "Turn on [device name]"
• "Turn off [device name]"
• "Set [device name] to [brightness]%"
• "Set [device name] to [color name or RGB]"
• "Dim/Brighten [device name]"

Setup

1. Get API key from Govee Developer Portal
2. Set environment variable: export GOVEE_API_KEY="your-key"
3. Install dependencies: pip3 install requests

Usage Examples

# List all devices
python3 scripts/govee.py list

# Control lights
python3 scripts/govee.py on "living room"
python3 scripts/govee.py off bedroom
python3 scripts/govee.py brightness "desk lamp" 50

# Set colors (RGB 0-255)
python3 scripts/govee.py color "strip" 255 0 0      # Red
python3 scripts/govee.py color "strip" 0 255 0      # Green
python3 scripts/govee.py color "strip" 255 165 0    # Orange

Troubleshooting

See TROUBLESHOOTING.md for common issues.