📋
Peter Steinbergerv1.0.0
Sonoscli
Control Sonos speakers on your local network — discover, play, pause, set volume, group, and queue music via CLI.
Peter Steinbergerv1.0.0ProductivityAutomationCLISelf-HostedDeveloper Tool
Connecting to VM...
Connecting to VM...
npx clawhub@latest install sonoscli52Stars
79.9kDownloads
11Current Installs
1.3kAll-time Installs
v1.0.0Version
Apr 30, 2026Updated
Requirements
Spotify API Key(optional)Spotify API Secret(optional)
Sonoscli Skill Overview
Sonos CLI (sonos) lets your AI agent control Sonos speakers on the local network through a simple command-line interface. It covers the full range of playback operations — discovery, status checks, play/pause/stop, volume adjustment, grouping, favorites, queues, and even Spotify search via SMAPI — without requiring the Sonos app or cloud authentication.
How to Use It
Step 1: Run in your terminal or install this skill on MyClaw
npx clawhub@latest install sonosclior
Click the Install button at the top of this page for one-click setup
When to Use Sonoscli
Best Fit
- You want to automate Sonos speaker control from an AI agent or script (e.g., "pause music when a meeting starts").
- You need to manage speaker groups, set volumes, or open favorites across multiple rooms programmatically.
- You want to search and play Spotify tracks on Sonos speakers using a CLI or automation workflow.
- You prefer a lightweight, local-network solution without relying on cloud APIs.
When Not to Use
- Your Sonos speakers are on a network that blocks SSDP multicast and you don't know the speaker IP addresses.
- You need support for non-Sonos audio hardware.
Key Features
Speaker Discovery & Status
Run sonos discover to find all Sonos speakers on the local network. Check playback state, track info, and volume for any named speaker with sonos status --name "Room".
Playback Control
Play, pause, or stop any speaker by name with a single command. Straightforward syntax makes it easy to wire into agent workflows or shell scripts.
Volume Management
Set the volume to an exact level on any speaker using sonos volume set <level> --name "Room", enabling precise, automated audio control.
Speaker Grouping
Join or unjoin speakers, create a party-mode group, or isolate a single speaker with the sonos group subcommands — useful for multi-room audio automation.
Favorites & Queue Management
List and open saved Sonos favorites, and manage the playback queue (list, play, or clear) without opening the Sonos app.
Spotify Search via SMAPI
Search for tracks, albums, or artists on Spotify and play them on a Sonos speaker using sonos smapi search. Optionally enhanced with Spotify API credentials for richer search results.
Use Cases
Meeting-aware audio automation
An agent can automatically pause music in the office when a calendar event starts and resume it when the meeting ends, using sonos pause and sonos play.
Multi-room party mode
Script a morning routine that joins all speakers into a group, opens a favorite playlist, and sets a comfortable volume — all via a single agent command.
Spotify track search and play
Ask your agent to find a specific song on Spotify and play it on a named speaker using the SMAPI search interface, without ever opening the Sonos or Spotify apps.
Home assistant integration
Wire Sonos CLI into a broader home-automation agent so it can respond to voice or text commands like "turn down the kitchen speakers" or "stop all music".
Requirements
- Spotify API Credentials (optional) — Enables richer Spotify search via SMAPI. Set
SPOTIFY_CLIENT_IDandSPOTIFY_CLIENT_SECRETfrom the Spotify Developer Dashboard.
Connecting to VM...
npx clawhub@latest install sonoscli52Stars
79.9kDownloads
11Current Installs
1.3kAll-time Installs
v1.0.0Version
Apr 30, 2026Updated
Requirements
Spotify API Key(optional)Spotify API Secret(optional)
FAQ
Reviews
0 reviewsLog in to write a review
No reviews yet. Be the first to share your experience!