sonoscli

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill sonoscli-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/sonoscli
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill sonoscli-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Sonos speakers typically requires the official mobile app, which is unavailable in headless, scripted, or automated environments. This Skill lets an AI agent discover, monitor, and control Sonos speakers directly from the command line. ## Core Features & Use Cases - Speaker Discovery & Status: Find speakers on the local network via SSDP and check playback state by name or IP. - Playback & Volume Control: Play, pause, stop, and set volume levels on any named speaker. - Grouping, Favorites & Queue Management: Join or unjoin speaker groups, open saved favorites, and manage the playback queue. - Spotify Search: Search tracks through SMAPI or the Spotify Web API using client credentials. - Use Case: Automate a morning routine where the agent discovers the Kitchen speaker, sets volume to 15, and plays a saved favorite playlist. ## Quick Start Ask the agent 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 --name "Kitchen" to control playback. Volume, grouping, favorites, and queue operations use similar subcommands.

How to group Sonos speakers using sonoscli?

Use the sonos group subcommands: status to view current groups, join to add a speaker to a group, unjoin to remove it, party to group all speakers, and solo to isolate one.

Why does Sonos speaker discovery fail on my network?

Discovery relies on SSDP multicast, which can be blocked by firewalls, VLANs, or VPNs. If SSDP fails, bypass discovery by specifying the speaker directly with the --ip flag followed by its IP address.

Can I search Spotify tracks with sonoscli?

Yes, use sonos smapi search --service "Spotify" --category tracks with your query. The optional Spotify Web API search requires setting SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

What are the requirements to install sonoscli?

You need Go installed to run go install github.com/steipete/sonoscli/cmd/sonos@latest, which produces the sonos binary. Speakers must be reachable on the local network.