sonoscli

Control Sonos speakers from the command line via the sonos binary.

117|8|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/geezerrrr/motive --skill sonoscli-geezerrrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/geezerrrr/motive/tree/main/Motive/Resources/Skills.bundle/sonoscli
Command: npx skills add https://github.com/geezerrrr/motive --skill sonoscli-geezerrrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control Sonos speakers on the local network from a simple command-line interface, reducing manual setup and navigation.

Core Features & Use Cases

  • Discover and manage Sonos speakers on the LAN.
  • Check status, play, pause, stop, and adjust volume for named rooms.
  • Group/ungroup speakers, manage queues and favorites, and perform Spotify searches via SMAPI.
  • Supports optional IP fallback for SSDP and requires Spotify credentials for some features.

Quick Start

Run the command 'sonos discover' to locate speakers on your local network.

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 terminal?

You can control Sonos speakers from the terminal by running commands to discover local-network devices, manage playback, adjust volume, and manage groups and queues. It requires the sonos binary present on the host and network access to Sonos devices.

Can I manage Sonos speaker groups and queues via a command line interface?

Yes, you can manage Sonos speaker groups and queues via a command line interface. The tool allows you to group and ungroup speakers, manage favorites, and control playback status for named rooms on your local network.

Do I need Spotify credentials to play music using a Sonos CLI?

Spotify credentials are optional and only required if you want to use SMAPI search functionality to find and play Spotify tracks. Basic Sonos playback, volume control, and device discovery on your local network do not require Spotify credentials.

How do I discover Sonos devices on a local network when SSDP fails?

If standard SSDP discovery fails to locate your Sonos devices, you can use an optional IP fallback to connect directly. This ensures you can still check status and control playback when automatic local network discovery does not work.

What is the best way to automate home audio playback for Sonos systems?

Automating home audio playback for Sonos systems is best handled through a command line interface that supports device discovery, playback control, and volume adjustment. This approach reduces manual setup and navigation for local-network setups.

Why does my Sonos CLI fail to discover local network speakers?

Your Sonos CLI may fail to discover local network speakers if the host lacks network access to Sonos devices or the sonos binary is missing. Ensure both are present, and consider using the optional IP fallback if standard SSDP discovery fails.