sonoscli

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

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill sonoscli-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/sonoscli
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill sonoscli-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Sonos speakers usually requires the official mobile app, which makes automation and scripting impossible. This Skill lets you discover, control, group, and queue audio on Sonos speakers directly from the command line. ## Core Features & Use Cases - Speaker Discovery & Status: Find Sonos devices on the local network with SSDP and check playback status by speaker name. - Playback & Volume Control: Play, pause, stop, and set volume on any named speaker, plus manage groups with join, unjoin, party, and solo modes. - Favorites, Queue & Spotify Search: List and open Sonos favorites, manage the play queue, and search Spotify tracks via SMAPI. - Use Case: Ask the assistant to lower the volume in the Kitchen and group it with the Living Room speaker for a house-wide playlist, all without opening the Sonos app. ## Quick Start Ask the assistant 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 with Go, then run commands like sonos discover to find speakers and sonos play, pause, stop, or volume set with the --name flag to target a specific speaker by name.

How do I 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 speaker.

Can I search Spotify from the Sonos command line?

Yes, use sonos smapi search with the --service Spotify flag and a category like tracks. Full Spotify Web API search additionally requires SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

Why does sonos discover fail with no route to host?

This SSDP error occurs on macOS when Local Network permission is not granted to the parent process, such as node, Terminal, or Visual Studio Code. Enable it in Settings under Privacy & Security, or run inside a Docker sandbox with network access.

What if SSDP discovery does not find my Sonos speaker?

If SSDP discovery fails, bypass it by specifying the speaker directly with the --ip flag followed by the speaker's IP address. This works even when multicast discovery is blocked on the network.