mcpField
S
sonoscli

sonoscli

github.com/insight68Other538 installsUpdated 30w ago
Repository

About sonoscli

sonoscli is a command-line skill for controlling Sonos speakers on a local network. It supports playback, volume, speaker groups, favorites, queues, and SMAPI-based Spotify search.

Key features

  1. 01Discover speakers on the network
  2. 02Control playback and volume
  3. 03Manage speaker groups
  4. 04List and open favorites
  5. 05Manage the playback queue
  6. 06Search Spotify via SMAPI

Use cases

  1. 01Find Sonos speakers on a local network
  2. 02Pause playback or adjust room volume
  3. 03Group speakers for shared playback
  4. 04Search Spotify tracks or manage the queue

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/insight68/skills --skill sonoscli

After installing, type/sonoscliin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported