sonoscli

Execute sonos commands to control playback, volume, grouping, and discovery on local networks.

4|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Agent-Pattern-Labs/sparse-kernel --skill sonoscli-agent-pattern-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/Agent-Pattern-Labs/sparse-kernel/tree/main/skills/sonoscli
Command: npx skills add https://github.com/Agent-Pattern-Labs/sparse-kernel --skill sonoscli-agent-pattern-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sonos, and includes scripts (resource) components.

What problem does it solve?

Manages and controls Sonos speakers for users who prefer command-line interaction, providing ease in discovering speakers, managing groups, playing/pausing/controlling volume, and more.

Core Features & Use Cases

  • Speaker Discovery and Status: Identify and check the status of Sonos speakers on the local network.
  • Playback Control: Play, pause, stop music, and adjust volume directly from the command line.
  • Grouping: Join, unjoin, party, and solo speakers for different audio experiences.
  • Favorites and Queue Management: List, open, and manipulate favorites and queues.
  • Spotify Integration: Search for tracks using Spotify Web API (with appropriate credentials).
  • Troubleshooting: Includes solutions for common issues such as SSDP failure and permission issues.

Quick Start

To discover Sonos speakers, use: sonos discover

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 by executing terminal commands to manage playback, adjust volume, and group speakers without needing a graphical user interface.

Can I group Sonos speakers together using terminal commands?

Yes, you can group Sonos speakers using terminal commands to join, unjoin, party, and solo devices for different audio experiences across your local network.

Does Sonos command-line control support Spotify integration?

Yes, Sonos command-line control supports Spotify integration, allowing you to search for tracks using the Spotify Web API when you provide the appropriate credentials.

What do I need to manage network audio playback on Sonos without a GUI?

To manage network audio playback on Sonos without a GUI, you need the 'sonos' binary installed and local network access to discover and interact with your speakers.

Why does Sonos speaker discovery fail with an SSDP error during command-line control?

Sonos speaker discovery fails with an SSDP error due to network communication issues, but the command-line tool includes troubleshooting solutions for common SSDP failures and permission problems.