sonoscli

Control Sonos speakers on local networks via the sonos command-line interface.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill sonoscli-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/sonoscli
Command: npx skills add https://github.com/srgaba/open-claw --skill sonoscli-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Sonos speakers typically requires the official mobile app, which is impractical for automation, scripting, or headless environments. This Skill lets you discover, monitor, and control Sonos speakers directly from the command line over the local network. ## Core Features & Use Cases - Speaker Discovery & Status: Find speakers via SSDP with sonos discover and check playback state with sonos status. - Playback & Volume Control: Play, pause, stop, and set volume on any named speaker. - Grouping, Favorites & Queue Management: Join or unjoin speaker groups, open favorites, and manage the play queue. - Spotify Search: Search tracks through SMAPI or the Spotify Web API using client credentials. - Use Case: Automate a morning routine that groups the Kitchen and Living Room speakers, sets volume to 15, and plays a saved favorite playlist. ## Quick Start Ask the assistant to discover Sonos speakers on the network and play music on the speaker 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 to find speakers and sonos play, pause, stop, or volume set with the --name flag to target a specific speaker.

How do I group Sonos speakers using a CLI?

Use sonos group with subcommands status, join, unjoin, party, or solo to manage speaker grouping. The party command groups all speakers together, while solo isolates one speaker.

Why does sonos discover fail with no route to host?

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

Can I search Spotify from the Sonos command line?

Yes, use sonos smapi search with the service set to Spotify and a category like tracks. Direct Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

What to do when Sonos speaker discovery does not work?

If SSDP discovery fails, bypass it by specifying the speaker directly with the --ip flag followed by the speaker IP address. Sandbox environments that block UDP binding may also require network access approval.