sonoscli

Control Sonos speakers on a local network via CLI.

4|2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/0xKobold/0xkobolds --skill sonoscli-0xkobold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/0xKobold/0xkobolds/tree/main/skills/sonoscli
Command: npx skills add https://github.com/0xKobold/0xkobolds --skill sonoscli-0xkobold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool lets you control Sonos speakers on your local network from the command line, unifying discovery, status, playback, and volume management in a single interface.

Core Features & Use Cases

  • Discover and inspect Sonos devices on the network.
  • Command playback (play, pause, stop) and adjust volume per speaker or group.
  • Manage groups, favorites, and queues, and perform searches via SMAPI when configured.
  • Use case: quickly control kitchen and living room speakers from scripts or a terminal session.

Quick Start

Install and run the sonos CLI to connect to your local speakers and begin controlling playback.

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 using a CLI interface that discovers devices on your local network and manages playback, volume, and grouping across multiple rooms.

Can I group Sonos speakers across multiple rooms using a terminal?

Yes, you can group Sonos speakers across multiple rooms using terminal commands to manage basic groupings, allowing synchronized playback in home and small-office scenarios.

What do I need to set up Sonos CLI playback control?

To set up Sonos CLI playback control, you need the Go toolchain and the sonos binary installed, with optional Spotify SMAPI search configured using SPOTIFY_CLIENT_ID and SECRET.

Does Sonos CLI support searching for music via Spotify?

Yes, Sonos CLI supports searching for music via Spotify SMAPI when you configure your SPOTIFY_CLIENT_ID and SECRET in the environment.

What is the best way to manage Sonos queues and favorites without an app?

The best way to manage Sonos queues and favorites without an app is using a CLI interface that unifies discovery, status checks, playback, and volume management in a single terminal session.

Are there limitations to controlling Sonos devices on a local network?

Limitations include requiring the Go toolchain and sonos binary, and the system is specifically designed for local network control in home and small-office scenarios rather than large-scale deployments.