sonoscli

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

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill sonoscli-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/sonoscli
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill sonoscli-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The sonoscli Skill removes the friction of manually controlling Sonos speakers by giving you a simple command-line way to discover devices, check status, and control playback and volume.

Core Features & Use Cases

  • Discovery and Status: Find Sonos speakers on the local network and query their current state (optionally by specifying IP).
  • Playback and Volume Control: Start, pause, stop, and set speaker volume for a named room/device.
  • Grouping and Queue Management: Manage speaker groups (join/unjoin/party/solo) and operate queues (list/play/clear), including optional Spotify SMAPI search support.

Quick Start

Run the command sonos discover, then use sonos status --name "Kitchen" to verify the speaker is reachable and ready.

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?

You can control Sonos speakers from the command line using a CLI tool to discover devices via SSDP, manage playback, adjust volume, and handle speaker grouping on your local network.

How do I discover Sonos devices on my local network?

You can discover Sonos devices on your local network by running the 'sonos discover' command, which uses SSDP-based network discovery to locate available speakers and check their status.

Can I manage speaker groups and queues for Sonos devices?

Yes, you can manage Sonos speaker groups and queues by executing commands to join, unjoin, party, or solo speakers, and operate queues by listing, playing, or clearing tracks.

Does the Sonos CLI support Spotify search?

Yes, the Sonos CLI supports Spotify search through optional SMAPI-based integration, allowing you to find tracks and add them to your speaker queue.

How do I target a specific Sonos speaker for playback control?

You can target a specific Sonos speaker for playback control by using its room name or IP address, such as running 'sonos status --name Kitchen' to verify and control that specific device.