sonos

name	sonos
description	Control Sonos speakers: discover, play/pause, volume, grouping, favorites, and queue management via sonos CLI.
requires_bridge	sonos

Sonos

Use the sonos bridge to control Sonos speakers via the sonos CLI on the host.

When to Use

• User asks to play/pause/skip on Sonos
• Adjusting volume on speakers
• Grouping/ungrouping speakers
• Playing favorites or managing queue

When NOT to Use

• Spotify direct control -> use spotify bridge
• Bluesound/NAD -> use blucli bridge
• Non-Sonos speakers

Commands

All commands run via host_execute(bridge="sonos", command="...").

Discovery & Status

sonos discover
sonos status --name "Kitchen"

Playback

sonos play --name "Kitchen"
sonos pause --name "Kitchen"
sonos stop --name "Kitchen"

Volume

sonos volume set 15 --name "Kitchen"
sonos volume up --name "Kitchen"
sonos volume down --name "Kitchen"

Grouping

sonos group status
sonos group join --name "Bedroom" --coordinator "Kitchen"
sonos group unjoin --name "Bedroom"
sonos group party                              # Group all speakers
sonos group solo --name "Kitchen"              # Ungroup one

Favorites & Queue

sonos favorites list
sonos favorites open --name "Kitchen" --favorite "My Playlist"
sonos queue list --name "Kitchen"
sonos queue clear --name "Kitchen"

Setup (on host)

• Install: go install github.com/steipete/sonoscli/cmd/sonos@latest
• Sonos speakers must be on local network
• If SSDP fails: sonos --ip <speaker-ip> status
• Uncomment sonos bridge in config.yaml, restart gateway