| 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
