--- name: hue description: Control Philips Hue lights locally via the bridge HTTP API. Use for turning lights on\/off, dimming, changing colors, and setting scenes. No cloud required. --- # Philips Hue Control Philips Hue lights locally through the bridge's REST API. ## Requirements - Philips Hue Bridge on local network - Bridge username\/API key (obtained through pairing) ## Setup ### 1. Find your bridge ```bash {baseDir}\/scripts\/hue.sh discover ``` Or check https:\/\/discovery.meethue.com\/ ### 2. Pair with the bridge ```bash {baseDir}\/scripts\/hue.sh pair ``` Press the button on your Hue bridge when prompted! ### 3. Save config Config is saved to `~\/.clawdbot\/hue\/config.json` ## Commands ```bash # List all lights {baseDir}\/scripts\/hue.sh lights # List all rooms\/groups {baseDir}\/scripts\/hue.sh groups # Control a light (by ID or name) {baseDir}\/scripts\/hue.sh light on {baseDir}\/scripts\/hue.sh light off {baseDir}\/scripts\/hue.sh light brightness 50 # 0-100 # Control a room\/group {baseDir}\/scripts\/hue.sh group on {baseDir}\/scripts\/hue.sh group off {baseDir}\/scripts\/hue.sh group brightness 75 # Scenes {baseDir}\/scripts\/hue.sh group scene "night" # warm red, dim {baseDir}\/scripts\/hue.sh group scene "normal" # warm white {baseDir}\/scripts\/hue.sh group scene "bright" # full daylight ``` ## Scenes Built-in scene presets: | Scene | Description | Settings | |-------|-------------|----------| | night | Sleep-safe, no blue light | Warm red, 15% brightness | | normal | Comfortable warm white | 2700K, 80% brightness | | bright | Full daylight | 4000K, 100% brightness | | red | Red | Hue 0, full saturation | | blue | Blue | Hue 46920, full saturation | | green | Green | Hue 25500, full saturation | ## Configuration Config file: `~\/.clawdbot\/hue\/config.json` ```json { "bridge_ip": "192.168.1.100", "username": "your-api-key-here" } ``` ## Troubleshooting **"Bridge not found"** — Check IP, ensure you're on the same network **"Unauthorized"** — Re-run pairing: `hue.sh pair ` **"HTTPS blocked"** — Use HTTP (default). Hue bridges often have cert issues with HTTPS.