sonoscli · diff
git:20260130.04b5b4c to git:20260131.562e9b6
21 added, 1 removed. Audit A to A.
---
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)"}]}}
+ 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`.