Music Service Playback
Control Sonos locally through one CLI across linked services such as Spotify, Apple Music, NetEase Cloud Music, and other ready playback paths on your runtime.
What It Does
Built for bots, operators, and smart-home workflows.
Reliable Interrupts
Insert TTS announcements or short news briefs, then return to music using the stable queue-insert path and recovery tooling.
Diagnostics First
Use setup, doctor, status, queue, and service probes to understand auth readiness, transport state, metadata accuracy, and queue health before acting.
Quick Start
Install the CLI and verify your local Sonos node.
ZoneFoundry works best on a Mac, Windows PC, NAS, mini PC, Raspberry Pi, or Docker host that stays on the same network as Sonos.
go install github.com/kisssam6886/zonefoundry/cmd/zf@latest
zf setup --format json
zf config set defaultRoom "Living Room"
zf play music "Adele" --service "Apple Music" --format jsonCore Paths
Practical commands for real local control.
Queue and Transport
zf status --name "Living Room" --format jsonzf queue list --format jsonzf queue prune --format jsonzf group rebuild --name "Living Room" --via "Bedroom"
Provider and TTS
zf service list --format jsonzf doctor service --service "Apple Music" --query "Adele" --format jsonzf play music "Sammi Cheng" --service "QQ音乐" --enqueue --format jsonzf say "One-minute news brief" --name "Living Room" --mode queue-insert --format json