| name | Sonos CLI (sonoscli) |
| description | CLI to discover and control Sonos speakers over local network — playback, grouping, queue, favorites, scenes, Spotify, and volume. Use when an agent needs to control music playback, manage speaker groups, or play Spotify on Sonos. |
sonoscli — Control Sonos speakers from your terminal
Modern Go CLI for Sonos speaker control over your local network (UPnP/SOAP).
Installation
brew install steipete/tap/sonoscli
Or build from source:
go install github.com/steipete/sonoscli/cmd/sonos@latest
Requirements
- Machine must be on the same network as Sonos speakers
- Speakers reachable on TCP port 1400
- Spotify must be linked in Sonos app (for Spotify features)
Key Commands
Discovery & Status
sonos discover
sonos discover --format json
sonos status --name "Kitchen"
sonos now --name "Kitchen"
Playback
sonos play --name "Kitchen"
sonos pause --name "Kitchen"
sonos stop --name "Kitchen"
sonos next --name "Kitchen"
sonos prev --name "Kitchen"
Volume & Mute
sonos volume get --name "Kitchen"
sonos volume set --name "Kitchen" 25
sonos mute toggle --name "Kitchen"
Speaker Grouping
sonos group status
sonos group join --name "Bedroom" --to "Living Room"
sonos group unjoin --name "Bedroom"
sonos group solo --name "Office"
sonos group party --to "Bar"
sonos group dissolve --name "Living Room"
Queue Management
sonos queue list --name "Kitchen"
sonos queue play --name "Kitchen" 1
sonos queue remove --name "Kitchen" 3
sonos queue clear --name "Kitchen"
Favorites
sonos favorites list --name "Kitchen"
sonos favorites open --name "Kitchen" --index 1
sonos favorites open --name "Kitchen" "BBC Radio 6 Music"
Spotify
sonos open --name "Kitchen" https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG
sonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
sonos play spotify --name "Office" "gareth emery"
sonos search spotify --type track "daft punk harder better"
sonos search spotify --open --name "Kitchen" "miles davis so what"
Scenes (Presets)
sonos scene save "Evening"
sonos scene apply "Evening"
sonos scene list
sonos scene delete "Evening"
Play Arbitrary URI
sonos play-uri --name "Kitchen" "https://example.com/stream.mp3"
sonos tv --name "Living Room"
sonos linein --name "Kitchen" --from "Living Room"
Watch Live Events
sonos watch --name "Kitchen"
sonos watch --name "Kitchen" --format json
Output Modes
--format plain (default)
--format json
--format tsv
--debug for trace logs
Configuration
sonos config set defaultRoom "Office"
sonos config set format json
sonos config get
Room targeting supports fuzzy substring matching — --name "Kit" matches "Kitchen".