sonoscli

Control Sonos speakers (discover/status/play/volume/group).

⭐430stars🔀44forks📁View on GitHub🕐Updated Dec 21, 2025

When & Why to Use This Skill

The Sonos CLI skill empowers Claude to interact directly with Sonos sound systems over a local network. By leveraging the sonoscli utility, this skill enables comprehensive speaker management—including device discovery, playback control, volume adjustment, and complex multi-room grouping—bridging the gap between AI assistance and smart home audio hardware.

Use Cases

  • 1. Automated Home Ambience: Use natural language to set up specific music environments by grouping speakers and triggering favorite playlists across different rooms.
  • 2. Hands-free Audio Management: Quickly adjust volume, skip tracks, or pause music playback across the entire house without needing to open a dedicated mobile app.
  • 3. Music Search and Queueing: Perform Spotify searches via SMAPI and manage playback queues or favorites directly through the AI agent interface.
  • 4. Network Diagnostics and Status: Monitor the connectivity and status of all Sonos devices on the local network, providing a quick way to troubleshoot hardware visibility issues.
namesonoscli
descriptionControl Sonos speakers (discover/status/play/volume/group).
homepagehttps://sonoscli.sh
metadata{"clawdbot":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}

Sonos CLI

Use sonos to control Sonos speakers on the local network.

Quick start

  • sonos discover
  • sonos status --name "Kitchen"
  • sonos play|pause|stop --name "Kitchen"
  • sonos volume set 15 --name "Kitchen"

Common tasks

  • Grouping: sonos group status|join|unjoin|party|solo
  • Favorites: sonos favorites list|open
  • Queue: sonos queue list|play|clear
  • Spotify search (via SMAPI): sonos smapi search --service "Spotify" --category tracks "query"

Notes

  • If SSDP fails, specify --ip <speaker-ip>.
  • Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID/SECRET.