Sonoscli

Name: Sonoscli
Author: steipete

steipete/clawdis

3.2k installs
385k repo stars
Updated August 3, 2026
steipete/clawdis

sonoscli is a skill for controlling Sonos speakers on the local network via the sonos CLI discover, play, volume, and group commands.

About

Sonos CLI is a skill for the sonos binary that controls Sonos speakers via local network discovery and named targeting. Install with go install github.com/steipete/sonoscli/cmd/sonos@latest per OpenClaw metadata. Quick commands include sonos discover, sonos status --name, play pause stop, and sonos volume set with a speaker name. Grouping covers group status, join, unjoin, and party modes. Favorites support list and open, queue supports list play and clear, and Spotify search runs via SMAPI with sonos smapi search --service Spotify. If SSDP discovery fails, pass --ip for a known speaker address. Optional Spotify Web API search needs SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables. Troubleshooting documents no route to host on macOS direct mode requiring Local Network permission for the Gateway parent process such as node launchd, Terminal, or VS Code, or using Docker sandbox with network allowed. Bind operation not permitted errors indicate Codex or other sandboxes blocking UDP; users must approve network escalation or run outside the sandbox.

sonos CLI for discover, playback, volume, grouping, favorites, and queue control.
Install via go install github.com/steipete/sonoscli/cmd/sonos@latest.
Spotify SMAPI search via sonos smapi search --service Spotify.
SSDP failures bypassed with --ip when speaker address is known.
macOS Local Network permission required for Gateway parent process on direct mode.

Sonoscli by the numbers

3,179 all-time installs (skills.sh)
+161 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #64 of 550 CLI & Terminal skills by installs in the Skillselion catalog
Security screen: MEDIUM risk (skills.sh audit)
Data as of Aug 3, 2026 (Skillselion catalog sync)

At a glance

sonoscli capabilities & compatibility

Capabilities: ssdp speaker discovery with ip fallback · playback, pause, stop, and volume control by spe · group join, unjoin, and party modes · favorites, queue management, and spotify smapi s
Use cases: orchestration
Platforms: macOS · Linux · Windows

From the docs

What sonoscli says it does

Settings -> Privacy & Security -> Local Network will need to be enabled for the top-level host parent process

SKILL.md

npx skills add https://github.com/steipete/clawdis --skill sonoscli

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/steipete/clawdis/sonoscli.svg)](https://skillselion.com/skills/steipete/clawdis/sonoscli)

Installs	3.2k
repo stars	★ 385k
Security audit	3 / 3 scanners passed
Last updated	August 3, 2026
Repository	steipete/clawdis ↗

How do agents discover and control Sonos speakers for playback, volume, and grouping from the command line?

Control Sonos speakers on the local network with the sonos CLI for discover, playback, volume, grouping, favorites, and queue management.

Who is it for?

Developers automating Sonos control on a local network with the sonos binary and proper macOS network permissions.

Skip if: Skip in network-sandboxed agent sessions without UDP access or on hosts without Sonos speakers reachable.

When should I use this skill?

User wants Sonos control, speaker discovery, volume changes, grouping, favorites, or Spotify search via sonos CLI.

What you get

Executed sonos commands for speaker discovery, transport control, volume, grouping, favorites, queue, or Spotify SMAPI search.

speaker control command results
group and queue state changes

Files

SKILL.mdMarkdownGitHub ↗

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.
If there is an error, check the troubleshooting section and offer advice if there is a decent match.

Troubleshooting

`sonos discover` - `no route to host`

On error Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)
Note that the port number after 0.0.0.0: is ephemeral and will change and the netmask may not match exactly either
The sendto: no route to host should stay consistent
Advise the user that in direct (no Docker sandbox) mode on Mac OS that Settings -> Privacy & Security -> Local Network will need to be enabled for the top-level host parent process of the Gateway
node if running via launchd
Terminal if running the gateway directly in the terminal
Visual Studio Code if running via terminal in VS Code
An alternative option is to use sandbox (docker container) with network access allowed for that sandbox

`sonos discover` - `bind: operation not permitted`

On error Error: listen udp4 0.0.0.0:0: bind: operation not permitted
Advise the user that they may be running via a Codex or other sandbox that does not permit network access (this can be replicated by running sonos discover within a Codex CLI session with sandbox enabled and not approving the escalation request)