sonoscli

Control Sonos speakers via CLI for discovery, playback, volume, and grouping.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/nomad3/openclaw-k8s --skill sonoscli-nomad3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/nomad3/openclaw-k8s/tree/main/package/skills/sonoscli
Command: npx skills add https://github.com/nomad3/openclaw-k8s --skill sonoscli-nomad3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SonosCLI solves the problem of manually interacting with Sonos speakers for common tasks like discovery, playback, volume control, and speaker grouping, especially when you want repeatable, scriptable control from the terminal.

Core Features & Use Cases

  • Discovery and Status: Find speakers on the local network and query their current state, such as what rooms/names are available and how they’re configured.
  • Playback and Volume Control: Start, pause, stop, and set volume for a specific speaker by name.
  • Grouping and Management: Inspect and manage grouped playback (join/unjoin/party/solo) and manage favorites and queue behavior for practical daily listening workflows.
  • Use Case: Running a “Kitchen” routine that discovers your speaker, checks its status, starts playback, and sets a target volume without touching the Sonos app.

Quick Start

Ask: "Discover my Sonos speakers and show the status for the Kitchen room."

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 terminal?

Sonos speaker control from the terminal involves using a command-line interface to discover devices on your local network, query status, manage playback, set volume, and handle speaker grouping for scripted audio routines.

Can I automate Sonos playback and volume control with a script?

Yes, you can automate Sonos playback and volume control by running terminal commands that start, pause, stop playback, and set target volume levels for specific speakers by room name without needing the Sonos app.

How do I discover Sonos speakers on my local network and check their status?

Network discovery for Sonos speakers involves scanning your local network to find available devices, then querying their current state to see available rooms, names, and grouped playback configurations for operational management.

Do I need Spotify credentials to search for music on Sonos?

To search for music on Sonos via Spotify SMAPI, you need to provide SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET, though basic speaker control, discovery, and grouping functions do not require Spotify credentials.

What's the best way to manage Sonos speaker grouping for party playback?

Managing Sonos speaker grouping for party playback involves using terminal commands to inspect current groups, join or unjoin specific speakers, and toggle party or solo modes for synchronized multi-room audio.

Why is my Sonos CLI not finding speakers on the network?

Sonos CLI fails to find speakers when the local network environment is misconfigured, requiring a working local network connection for device discovery; you can optionally use a speaker IP override to connect directly if discovery fails.