← Back to Smart Home & IoT
Smart Home & IoT by @joeynyc

govee-lights

Control Govee smart lights via the Govee API

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.