sonoscli

Control Sonos speakers on the local network via CLI commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of manually controlling Sonos speakers by providing a CLI to discover devices, check status, play, pause, adjust volume, and manage groups on the local network.

Core Features & Use Cases

  • Discover devices on the network.
  • Playback control: play, pause, stop, and volume adjustments for a named room.
  • Grouping, queue management, and favorites for seamless multi-room listening.
  • Spotify search via SMAPI for extended track availability.

Quick Start

Discover devices on the network and start playback in a chosen room.

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 a command line interface?

Control Sonos speakers on your local network by discovering devices, querying status, and issuing playback and volume commands using a local CLI binary. It enables room-based playback, grouping, favorites, and queue management.

Can I search and play Spotify tracks directly on Sonos speakers?

Yes, you can search and play Spotify tracks on Sonos speakers via SMAPI integration. This requires setting up and providing your own SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.

What do I need to manage Sonos multi-room grouping and playback?

To manage Sonos multi-room grouping, playback, and volume, you need the local 'sonos' binary or equivalent tooling installed. The CLI then discovers devices on your local network to issue room-based commands.

How does network discovery work for home audio devices like Sonos?

Network discovery for Sonos home audio devices works by scanning your local network to identify available speakers. Once discovered, the CLI queries device status and issues targeted playback commands to specific rooms or groups.

Does Sonos CLI support managing playback queues and favorites?

Yes, Sonos CLI supports queue management and favorites for seamless multi-room listening. You can issue commands to add tracks, manage queues, and trigger saved favorites across discovered local network devices.

Why is my Spotify search not working with the Sonos CLI?

Spotify search fails when SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are missing or invalid. You must configure these credentials correctly to enable the SMAPI integration for extended track availability on Sonos.