AgentSkillsCN

sonoscli

控制 Sonos 音箱(发现设备、查询状态、播放音乐、调节音量、创建分组)。

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