sonoscli

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

⭐3.1kstars🔀474forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The sonoscli skill enables Claude to interact directly with Sonos sound systems on a local network. By leveraging a powerful command-line interface, it allows for comprehensive speaker management including device discovery, playback control, volume adjustment, and multi-speaker grouping, bridging the gap between AI assistance and physical hardware automation.

Use Cases

  • Smart Office Management: Automatically control background music, pause audio during scheduled meetings, or adjust volume levels across different office zones.
  • Multi-room Audio Coordination: Use natural language to group or ungroup speakers (party mode/solo mode) for synchronized audio playback throughout a building.
  • Music Library & Streaming Control: Search for tracks via Spotify (SMAPI), manage playback queues, and access favorite playlists without leaving the chat interface.
  • Hardware Status Monitoring: Quickly retrieve the current status, volume, and connectivity of any Sonos speaker on the network for troubleshooting or routine checks.
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.