Start

Quickstart

GitHub Edit page

Quickstart

This walks through the moves you'll use every day. Replace Kitchen / Living Room with your actual room names.

#1. Discover speakers

sonos discover

You should see one row per visible Sonos zone, with name, model, and IP. JSON works too:

sonos discover --format json

The first run also caches speaker names so --name <Tab> autocompletes.

#2. Check what's playing

sonos status --name "Kitchen"
sonos now --name "Kitchen"           # alias
sonos status --name "Kitchen" --format json

status reports on the group coordinator — even if you ask a satellite, you get the truthful playback state.

#3. Control playback

sonos play  --name "Kitchen"
sonos pause --name "Kitchen"
sonos next  --name "Kitchen"
sonos prev  --name "Kitchen"
sonos volume set --name "Kitchen" 25
sonos mute toggle --name "Kitchen"

If Spotify is already linked in the Sonos app, you don't need any Spotify Web API setup:

sonos open --name "Kitchen" "https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG"
sonos open --name "Kitchen" spotify:album:0nrRP2bk19rLc0orkWPQk2
sonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M --next

#5. Group rooms

sonos group status
sonos group join   --name "Kitchen" --to "Living Room"
sonos group party  --to "Living Room"
sonos group volume set --name "Living Room" 18
sonos group unjoin --name "Kitchen"
sonos group dissolve --name "Living Room"

#6. Save and apply scenes

A scene captures grouping plus per-room volume/mute. Save what's good now, restore it later.

sonos scene save evening
sonos scene list
sonos scene apply evening

#7. Watch live events

sonos watch --name "Kitchen"

Subscribes to AVTransport + RenderingControl and prints state changes as they arrive (Ctrl+C to stop).

#8. Search via Sonos (no Spotify credentials)

sonos smapi services
sonos smapi search --service "Spotify" --category tracks "miles davis kind of blue"
sonos play spotify --name "Kitchen" --category albums "kind of blue"

If a service needs a one-time link first:

sonos auth smapi begin    --service "Spotify"
sonos auth smapi complete --service "Spotify" --wait 2m

#Where to go next