sonoscli

Control Sonos speakers via local network for playback, volume, and grouping.

4|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/bitan-del/gods-eye --skill sonoscli-bitan-del
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonoscli
Source: https://github.com/bitan-del/gods-eye/tree/main/skills/sonoscli
Command: npx skills add https://github.com/bitan-del/gods-eye --skill sonoscli-bitan-del

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps users manage Sonos speakers on their local network from a single programmable interface.

Core Features & Use Cases

  • Discover, check status, and control playback (play/pause/stop) across multiple speakers.
  • Adjust volume, group speakers, and manage groups for synchronized playback.
  • Optional Spotify search via SMAPI to locate tracks and play them on selected speakers.

Quick Start

Run sonos discover to locate speakers, then use sonos status or sonos play to verify connectivity and control 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 across a local network?

Control Sonos speakers across a local network by running local network discovery via SSDP, then executing playback, volume, and grouping commands to manage your home audio setup from a single programmable interface.

How do I group Sonos speakers for synchronized playback?

Group Sonos speakers for synchronized playback by using group management commands to form groups across your local network, allowing multiple speakers to play audio simultaneously throughout your home.

Can I search and play Spotify tracks on Sonos speakers?

Yes, you can search and play Spotify tracks on Sonos speakers using the optional Spotify search integration via SMAPI to locate specific tracks and play them on your selected devices.

What's the best way to check Sonos speaker status and current playback?

The best way to check Sonos speaker status and current playback is to run a status command after discovering the devices, which verifies connectivity and retrieves the active playback state for your local network speakers.

Does local network discovery require any specific protocols for Sonos?

Local network discovery for Sonos requires the SSDP protocol to locate speakers on your network, ensuring that all available home audio devices are found before sending playback or volume commands.

Why does my Sonos grouping command fail to synchronize playback?

Sonos grouping commands may fail if local network discovery via SSDP has not located the target speakers, or if the selected devices are not properly connected to the same local network for synchronized playback.