AgentSkillsCN

sonoscli

控制 Sonos 音箱（发现设备、查询状态、播放音乐、调节音量、组建播放列表）。

SKILL.md
--- frontmatter
name: sonoscli
description: Control Sonos speakers (discover/status/play/volume/group).
homepage: https://sonoscli.sh
metadata:
  {
    "hex":
      {
        "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.