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

Get API key from [Govee Developer Portal]()

Set environment variable: export GOVEE_API_KEY="your-key"

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.