Sonoscli

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

Peter Steinberger

@steipete

What This Skill Does

Command-line tool to discover, control, and group Sonos speakers on the local network. Supports play/pause/stop, volume adjustment, queue management, favorites, and Spotify search via SMAPI.

Replaces manually using the Sonos app for each action by exposing speaker controls, grouping, and media management through a single CLI.

When to Use It

  • Discover all Sonos speakers on the local network
  • Pause or stop music on a specific speaker from a script
  • Set the volume of a speaker to a specific level
  • Group multiple speakers into a party or solo a speaker
  • Open and play a saved Sonos favorite
  • Search Spotify for tracks and play them on a speaker

Install

$ openclaw skills install @steipete/sonoscli

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.

Top skills in this category