sonoscli

Control Sonos speakers on the local network via the sonos CLI.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill sonoscli-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/sonoscli
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill sonoscli-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Sonos speakers from a terminal or AI assistant normally requires manual app interaction; this Skill lets you discover, play, group, and adjust speakers directly from the command line. ## Core Features & Use Cases - Speaker Discovery & Status: Run sonos discover and sonos status to find speakers on the LAN and inspect their state. - Playback & Volume Control: Play, pause, stop, and set volume per speaker by name, plus manage groups, favorites, and queues. - Spotify Search via SMAPI: Search Spotify tracks through sonos smapi search with optional Spotify Web API credentials. - Use Case: Ask the assistant to play music in the Kitchen at volume 15, and it runs sonos play --name "Kitchen" and sonos volume set 15 --name "Kitchen" for you. ## Quick Start Ask the assistant to discover your Sonos speakers and play music on the one named Kitchen.

Frequently Asked Questions about sonoscli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Sonos speakers from the command line?

Install the sonos CLI via Go, then run commands like sonos discover, sonos play --name "Kitchen", and sonos volume set 15 --name "Kitchen". It supports playback, grouping, favorites, and queue management over the local network.

How do I group Sonos speakers using sonoscli?

Use the sonos group subcommands: status, join, unjoin, party, and solo. For example, sonos group party joins all speakers into one group, while solo isolates a single speaker.

Why does sonos discover fail with no route to host?

This SSDP error occurs on macOS when Local Network permission is disabled for the host process such as node, Terminal, or VS Code. Enable it under Settings > Privacy & Security > Local Network, or run in a Docker sandbox with network access.

Can I search Spotify from the Sonos CLI?

Yes, use sonos smapi search --service "Spotify" --category tracks "query" to search via SMAPI. Optional Spotify Web API search requires setting SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

What causes bind: operation not permitted with sonos discover?

This error means the process runs inside a sandbox, such as a Codex CLI session, that blocks UDP socket binding. Approve the network escalation request or run the command outside the sandboxed environment.