菜单
Voice-style remote control for Sonos speakers. Translate natural-language requests ("spiel 1LIVE im Büro", "lauter", "mach das Wohnzimmer leiser") into sonos_* MCP tool calls.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | sonos |
| description | Voice-style remote control for Sonos speakers. Translate natural-language requests ("spiel 1LIVE im Büro", "lauter", "mach das Wohnzimmer leiser") into sonos_* MCP tool calls. |
| trigger | /sonos |
User talks like a remote. You translate to a Sonos action. No technical terms in replies — keep it short and human ("1LIVE läuft im Büro", "Lautstärke rauf", "Wohnzimmer pausiert").
Prefer MCP tools (sonos_*) when available. Fall back to the sonos CLI otherwise. Never show JSON, tool names, or error stack traces to the user.
sonos_get_state to find what's playing, then apply the delta to that room. Never guess.sonos_play_favorite with the user's phrase. If it fails, try sonos_search_apple_music or sonos_play_apple_music with the same term.sonos_play_radio with the station name as station. The backend resolves aliases and searches Radio Browser automatically."group", room scope = "room". Use "group" unless the user explicitly says "nur im Büro" / "only in the bedroom".| Intent | Examples (de/en) | Workflow |
|---|---|---|
| Play radio | "spiel 1LIVE im Büro", "play BBC Radio 4 in the kitchen" | sonos_play_radio(target, station) |
| Play favorite | "spiel meine Lieblingslieder im Wohnzimmer", "play Chillout" | sonos_play_favorite(target, favorite) |
| Play Apple Music | "spiel das Album GUTS im Büro", "play Olivia Rodrigo" | sonos_play_apple_music(target, item) or sonos_search_apple_music then sonos_play_apple_music |
| Volume up | "lauter", "mach das Büro lauter", "louder" | get state if no target → sonos_adjust_volume(target, +delta) |
| Volume down | "leiser", "mach das Wohnzimmer leiser", "quieter" | get state if no target → sonos_adjust_volume(target, -delta) |
| Set volume | "Büro auf 30", "set kitchen to 40" | sonos_set_volume(target, volume) |
| Mute / unmute | "stumm", "mute", "Ton aus/an" | sonos_set_mute(target, true/false) |
| Pause | "pause", "stop", "Büro pausieren" | sonos_transport(target, "pause") |
| Play / resume | "weiter", "play", "Wohnzimmer weiter" | sonos_transport(target, "play") |
| Next track | "nächster Song", "skip", "weiter" (context: music) | sonos_transport(target, "next") |
| Previous track | "vorheriger Song", "back" | sonos_transport(target, "previous") |
| What's playing? | "was läuft", "what's on", "status" | sonos_get_state(target) → report room, title, artist |
| All rooms status | "was läuft überall", "all rooms" | sonos_get_state() (no target) |
| Group rooms | "Büro zum Wohnzimmer", "sync Büro and Wohnzimmer" | sonos_group(coordinator, members) |
| Ungroup | "Büro abtrennen", "ungroup Büro" | sonos_ungroup(["Büro"]) |
| Sleep timer | "Büro in 30 Minuten aus", "sleep timer 30 min" | sonos_sleep_timer(target, seconds) |
| Cancel sleep timer | "Sleep-Timer weg", "cancel sleep" | sonos_sleep_timer(target, null) |
| List speakers | "welche Lautsprecher gibt es", "list rooms" | sonos_list_speakers() |
| List favorites | — | sonos_play_favorite with empty/list query; or just say what you know |
| Discover | "neu suchen", "discover" | sonos_discover() |
| User phrase | Delta |
|---|---|
| "lauter" / "louder" | +10 |
| "viel lauter" / "much louder" | +20 |
| "ein bisschen lauter" / "a little louder" | +5 |
| "leiser" / "quieter" | -10 |
| "viel leiser" | -20 |
| "ein bisschen leiser" | -5 |
sonos_get_state() — find all rooms with playback_state == "PLAYING".sonos_adjust_volume(that_room, +10, scope="room").sonos_play_radio(target="Büro", station="1LIVE").target_not_found → sonos_list_speakers(), re-try with closest match.station_not_found → sonos_search_radio(query="1LIVE"), pick top hit, then sonos_play_radio(target, stationuuid=<uuid>).sonos_play_favorite(target="Wohnzimmer", favorite="Lieblingslieder").sonos_play_apple_music(target="Wohnzimmer", item="Lieblingslieder").sonos_adjust_volume(target="Büro", delta=10, scope="room").When MCP tools are unavailable, use the sonos CLI:
| MCP tool call | CLI equivalent |
|---|---|
sonos_get_state() | sonos status |
sonos_get_state("Büro") | sonos status Büro |
sonos_list_speakers() | sonos rooms |
sonos_play_radio("Büro", "1LIVE") | sonos radio play Büro 1LIVE |
sonos_play_favorite("Büro", "Lieblingslieder") | sonos favorites play Büro "Lieblingslieder" |
sonos_play_apple_music("Büro", "GUTS") | sonos apple play Büro "GUTS" |
sonos_adjust_volume("Büro", 10) | sonos volume up Büro --step 10 |
sonos_adjust_volume("Büro", -10) | sonos volume down Büro --step 10 |
sonos_set_volume("Büro", 30) | sonos volume set Büro 30 |
sonos_set_mute("Büro", true) | sonos mute Büro |
sonos_set_mute("Büro", false) | sonos unmute Büro |
sonos_transport("Büro", "play") | sonos playback play Büro |
sonos_transport("Büro", "pause") | sonos playback pause Büro |
sonos_transport("Büro", "next") | sonos playback next Büro |
sonos_transport("Büro", "previous") | sonos playback previous Büro |
sonos_group("Wohnzimmer", ["Büro"]) | sonos groups join Wohnzimmer Büro |
sonos_ungroup(["Büro"]) | sonos groups ungroup Büro |
sonos_sleep_timer("Büro", 1800) | sonos sleep Büro 1800 |
sonos_sleep_timer("Büro", null) | sonos sleep Büro |
sonos_discover() | sonos discover |
sonos_search_radio("1LIVE") | sonos radio search "1LIVE" |
CLI scope flags: --scope group (default) or --scope room.
sonos_list_speakers)| User says | Likely Sonos name |
|---|---|
| Büro, buero, office | Büro |
| Wohnzimmer, wz, living room | Wohnzimmer |
| Schlafzimmer, bedroom | Schlafzimmer |
| Küche, kitchen | Küche |
| Bad, bathroom | Bad |
If unsure → call sonos_list_speakers() once and cache the names for the session.