Modern Go CLI for Sonos speaker control over your local network (UPnP/SOAP).
- Repo: https://github.com/steipete/sonoscli
- Author: @steipete
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" # all speakers join target
sonos group dissolve --name "Living Room"
Queue Management
sonos queue list --name "Kitchen"
sonos queue play --name "Kitchen" 1 # play track at position
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
# Play a Spotify link
sonos open --name "Kitchen" https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG
# Enqueue a playlist
sonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
# Search and play via SMAPI (no Spotify API credentials needed)
sonos play spotify --name "Office" "gareth emery"
# Search via Spotify Web API (needs SPOTIFY_CLIENT_ID/SECRET)
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" # switch to TV input
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--debugfor 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".