Home Control
Control Yeelight bulbs and Google Cast speakers on the local network using the scripts/home.py script bundled with this skill.
CLI Reference
All commands output JSON. Always run from the skill's scripts directory (the base directory is provided above as "Base directory for this skill"):
cd <base-directory>/scripts
Discover devices
python3 home.py discover [--timeout 5]
Device status
python3 home.py status [--cached]
Light control
python3 home.py lights --device NAME --action {on,off,toggle,brightness,ct} [--value N]
--device: fuzzy name match or all-lightsbrightness: value 1-100ct: color temperature 1700-6500K (lower=warm, higher=cool)
Cast/speaker control
python3 home.py cast --device NAME --action {play,stop,pause,volume,status} [--url URL] [--stream GENRE] [--volume N]
--device: fuzzy name match, all-speakers, or a specific group/speaker name--stream: genre keyword (jazz, ambient, metal, electronic, etc.) — maps to SomaFM AAC streams--url: direct audio URL (overrides --stream). Must be HTTP (not HTTPS) for Cast compatibility.--volume: 0-100
Known devices
| Name |
Type |
Notes |
| Kitchen speaker |
Google Home Mini |
Individual speaker |
| Living Room speaker |
Google Nest Mini |
Individual speaker |
| Master Room speaker old |
Google Home Mini |
Individual speaker |
| Living Room TV 2 |
Chromecast |
TV, may not play audio-only |
| Motz |
Cast Group |
Multi-room group — preferred for "play everywhere" |
| SoundedX |
Cast Group |
Multi-room group |
Multi-room audio
For "play on all speakers" or "play everywhere", use --device all-speakers. This targets speaker groups (Motz, SoundedX) rather than individual devices. Playing on individual Cast speakers sequentially is unreliable; groups handle sync natively.
For single-room playback, target the specific speaker by name (e.g., --device kitchen).
Workflow
- Parse the user's intent into one or more device actions (light control, audio playback, scenes).
- Resolve devices: use fuzzy name matching. For compound commands ("play jazz and dim the lights"), issue multiple CLI calls.
- Resolve genres autonomously: if a genre keyword returns an "unknown stream/genre" error, do NOT ask the user to choose. Instead, consult
references/somafm-channels.md, pick the closest matching channel, and play it immediately. Mention which channel was chosen. Fallback priority: match by subgenre, then by mood/energy, then by era.
- Execute commands via
python3 home.py ... and read JSON output.
- Report results naturally. On success, confirm briefly ("Lights dimmed to 40%"). On error, explain and suggest fixes.
Scene Presets
When the user says one of these, execute the corresponding commands:
"goodnight" / "bedtime":
lights --device all-lights --action offcast --device all-speakers --action stop
"movie mode" / "movie time":
lights --device all-lights --action brightness --value 15lights --device all-lights --action ct --value 2700
"reading mode":
lights --device all-lights --action brightness --value 80lights --device all-lights --action ct --value 4000
"focus" / "work mode":
lights --device all-lights --action brightness --value 100lights --device all-lights --action ct --value 5000cast --device all-speakers --action stop
"relax" / "chill":
lights --device all-lights --action brightness --value 40lights --device all-lights --action ct --value 2700cast --device all-speakers --action play --stream ambient
SomaFM Genre Keywords
See references/somafm-channels.md for the full list. Common mappings:
| Genre keyword |
Channel |
| jazz, spy, lounge |
Secret Agent |
| ambient, chill |
Groove Salad |
| metal, heavy |
Metal |
| electronic, electronica |
cliqhop |
| folk |
Folk Forward |
| 80s |
Underground 80s |
| country, americana |
Boot Liquor |
| space |
Space Station |
| drone |
Drone Zone |
If a genre is not directly mapped, autonomously pick the closest channel from references/somafm-channels.md and play it. Never ask the user to choose — just pick the best fit and mention what was selected.
Troubleshooting
- "no lights matching": Lights may be powered off at the switch. Run
discover to re-scan.
- "pychromecast not installed": Run
bash <base-directory>/scripts/setup.sh
- Cast device not found: Device may be asleep. Try increasing timeout:
--timeout 10
- Cast plays but no sound / "IDLE" after play: Streams must use HTTP AAC format (not HTTPS MP3). The built-in SomaFM URLs already use the correct format. For custom URLs, ensure they are HTTP and the content type matches.
- Connection refused on Yeelight: Ensure "LAN Control" is enabled in the Yeelight app for each bulb.
- Stale cache: Run
discover to force a fresh scan (bypasses the 30-min cache).
- Multi-room not working: Target a Cast group (Motz, SoundedX) instead of individual speakers. Playing on individual speakers sequentially is unreliable due to zeroconf session conflicts.
1---2name: home-control3description: This skill should be used when the user wants to control smart home devices — lights, speakers, music playback, or scenes. Triggers on phrases like 'turn on the lights', 'play some jazz', 'dim the lights', 'stop the music', 'goodnight', 'movie mode', 'what's playing', or any reference to Yeelight bulbs, Google Cast speakers, or SomaFM radio.4---56# Home Control78Control Yeelight bulbs and Google Cast speakers on the local network using the `scripts/home.py` script bundled with this skill.910## CLI Reference1112All commands output JSON. Always run from the skill's scripts directory (the base directory is provided above as "Base directory for this skill"):1314```15cd <base-directory>/scripts16```1718### Discover devices19```bash20python3 home.py discover [--timeout 5]21```2223### Device status24```bash25python3 home.py status [--cached]26```2728### Light control29```bash30python3 home.py lights --device NAME --action {on,off,toggle,brightness,ct} [--value N]31```32- `--device`: fuzzy name match or `all-lights`33- `brightness`: value 1-10034- `ct`: color temperature 1700-6500K (lower=warm, higher=cool)3536### Cast/speaker control37```bash38python3 home.py cast --device NAME --action {play,stop,pause,volume,status} [--url URL] [--stream GENRE] [--volume N]39```40- `--device`: fuzzy name match, `all-speakers`, or a specific group/speaker name41- `--stream`: genre keyword (jazz, ambient, metal, electronic, etc.) — maps to SomaFM AAC streams42- `--url`: direct audio URL (overrides --stream). Must be HTTP (not HTTPS) for Cast compatibility.43- `--volume`: 0-1004445### Known devices4647| Name | Type | Notes |48|---|---|---|49| Kitchen speaker | Google Home Mini | Individual speaker |50| Living Room speaker | Google Nest Mini | Individual speaker |51| Master Room speaker old | Google Home Mini | Individual speaker |52| Living Room TV 2 | Chromecast | TV, may not play audio-only |53| **Motz** | **Cast Group** | Multi-room group — preferred for "play everywhere" |54| **SoundedX** | **Cast Group** | Multi-room group |5556### Multi-room audio5758For "play on all speakers" or "play everywhere", use `--device all-speakers`. This targets **speaker groups** (Motz, SoundedX) rather than individual devices. Playing on individual Cast speakers sequentially is unreliable; groups handle sync natively.5960For single-room playback, target the specific speaker by name (e.g., `--device kitchen`).6162## Workflow63641. **Parse the user's intent** into one or more device actions (light control, audio playback, scenes).652. **Resolve devices**: use fuzzy name matching. For compound commands ("play jazz and dim the lights"), issue multiple CLI calls.663. **Resolve genres autonomously**: if a genre keyword returns an "unknown stream/genre" error, do NOT ask the user to choose. Instead, consult `references/somafm-channels.md`, pick the closest matching channel, and play it immediately. Mention which channel was chosen. Fallback priority: match by subgenre, then by mood/energy, then by era.674. **Execute commands** via `python3 home.py ...` and read JSON output.685. **Report results** naturally. On success, confirm briefly ("Lights dimmed to 40%"). On error, explain and suggest fixes.6970## Scene Presets7172When the user says one of these, execute the corresponding commands:7374**"goodnight"** / **"bedtime"**:75- `lights --device all-lights --action off`76- `cast --device all-speakers --action stop`7778**"movie mode"** / **"movie time"**:79- `lights --device all-lights --action brightness --value 15`80- `lights --device all-lights --action ct --value 2700`8182**"reading mode"**:83- `lights --device all-lights --action brightness --value 80`84- `lights --device all-lights --action ct --value 4000`8586**"focus"** / **"work mode"**:87- `lights --device all-lights --action brightness --value 100`88- `lights --device all-lights --action ct --value 5000`89- `cast --device all-speakers --action stop`9091**"relax"** / **"chill"**:92- `lights --device all-lights --action brightness --value 40`93- `lights --device all-lights --action ct --value 2700`94- `cast --device all-speakers --action play --stream ambient`9596## SomaFM Genre Keywords9798See `references/somafm-channels.md` for the full list. Common mappings:99100| Genre keyword | Channel |101|---|---|102| jazz, spy, lounge | Secret Agent |103| ambient, chill | Groove Salad |104| metal, heavy | Metal |105| electronic, electronica | cliqhop |106| folk | Folk Forward |107| 80s | Underground 80s |108| country, americana | Boot Liquor |109| space | Space Station |110| drone | Drone Zone |111112If a genre is not directly mapped, autonomously pick the closest channel from `references/somafm-channels.md` and play it. Never ask the user to choose — just pick the best fit and mention what was selected.113114## Troubleshooting115116- **"no lights matching"**: Lights may be powered off at the switch. Run `discover` to re-scan.117- **"pychromecast not installed"**: Run `bash <base-directory>/scripts/setup.sh`118- **Cast device not found**: Device may be asleep. Try increasing timeout: `--timeout 10`119- **Cast plays but no sound / "IDLE" after play**: Streams must use **HTTP AAC** format (not HTTPS MP3). The built-in SomaFM URLs already use the correct format. For custom URLs, ensure they are HTTP and the content type matches.120- **Connection refused on Yeelight**: Ensure "LAN Control" is enabled in the Yeelight app for each bulb.121- **Stale cache**: Run `discover` to force a fresh scan (bypasses the 30-min cache).122- **Multi-room not working**: Target a Cast group (Motz, SoundedX) instead of individual speakers. Playing on individual speakers sequentially is unreliable due to zeroconf session conflicts.
kjgarza