47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
---
|
|
name: sonoscli
|
|
description: Control Sonos speakers (discover/status/play/volume/group).
|
|
homepage: https://sonoscli.sh
|
|
metadata:
|
|
{
|
|
"openclaw":
|
|
{
|
|
"emoji": "🔊",
|
|
"requires": { "bins": ["sonos"] },
|
|
"install":
|
|
[
|
|
{
|
|
"id": "go",
|
|
"kind": "go",
|
|
"module": "github.com/steipete/sonoscli/cmd/sonos@latest",
|
|
"bins": ["sonos"],
|
|
"label": "Install sonoscli (go)",
|
|
},
|
|
],
|
|
},
|
|
}
|
|
---
|
|
|
|
# Sonos CLI
|
|
|
|
Use `sonos` to control Sonos speakers on the local network.
|
|
|
|
Quick start
|
|
|
|
- `sonos discover`
|
|
- `sonos status --name "Kitchen"`
|
|
- `sonos play|pause|stop --name "Kitchen"`
|
|
- `sonos volume set 15 --name "Kitchen"`
|
|
|
|
Common tasks
|
|
|
|
- Grouping: `sonos group status|join|unjoin|party|solo`
|
|
- Favorites: `sonos favorites list|open`
|
|
- Queue: `sonos queue list|play|clear`
|
|
- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
|
|
|
|
Notes
|
|
|
|
- If SSDP fails, specify `--ip <speaker-ip>`.
|
|
- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.
|