sonoscli

Control Sonos speakers for discovery, playback, volume, grouping, and queue management.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill sonoscli-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/sonoscli
Command: npx skills add https://github.com/kcns008/clusterclaw --skill sonoscli-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of managing Sonos speakers by letting you discover devices, control playback, adjust volume, and organize multi-room audio without opening a separate app.

Core Features & Use Cases

  • Speaker Discovery and Status: Find speakers on the local network and check what is currently playing.
  • Playback and Volume Control: Play, pause, stop, and set volume for a named speaker or room.
  • Grouping and Queue Management: Join rooms, create party mode, manage the queue, and open favorites.
  • Use Case: Ask it to find your kitchen speaker, start a playlist, and lower the volume for a late-night listening session.

Quick Start

Use the sonoscli skill to discover your speakers and control playback, volume, or grouping for the room you name.

Frequently Asked Questions about sonoscli

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

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

You can control Sonos speaker playback from the command line by using the sonos CLI to issue play, pause, and stop commands to a named speaker or room. This automates local network device control without requiring the official app.

Can I manage multi-room audio grouping for Sonos speakers via CLI?

Yes, you can manage multi-room audio grouping for Sonos speakers via CLI by joining rooms and creating party mode. The CLI executes grouping commands over the local network to synchronize playback across multiple named devices.

How do I find Sonos devices on my local network when discovery fails?

To find Sonos devices when local network discovery fails, you can apply IP overrides to manually target specific speakers. This bypasses standard automatic discovery and directly reaches the speaker for status and playback control.

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

You need optional Spotify API credentials to enable SMAPI-based search for music on Sonos. Without these credentials, you can still control playback, volume, and grouping, but direct Spotify search functionality will be unavailable.

What's the best way to automate office audio workflows with Sonos speakers?

The best way to automate office audio workflows with Sonos speakers is using CLI commands to trigger discovery, adjust volume, and manage grouped playback. This allows scripted scheduling for background music across multiple rooms.

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

Your Sonos CLI may not be finding speakers on the network due to local discovery failures, which can be resolved by providing IP overrides. This manually directs the CLI to the correct speaker address for status checks and control.