Skills/ #other

Sonoscli

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

Peter Steinberger@steipete

Install

Run this command against the local KakaHub registry.

Install sonoscli from the local KakaHub registry at http://localhost:13001. Review the README, manifest, and permissions before using it in the current workspace.

Download

README

--- name: sonoscli description: Control Sonos speakers (discover/status/play/volume/group). homepage: https://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`.

Install resolver

{
  "artifact": {
    "downloadUrl": "/api/v1/download?slug=sonoscli&version=1.0.0&ownerHandle=steipete",
    "format": "zip",
    "generated": true,
    "kind": "skillArchive",
    "sha256": "ac764693b31d3b2dd3c0969fb13404910f0bb8da5e2246f60554d6d7150967c8",
    "size": 1987
  },
  "owner": {
    "displayName": "Peter Steinberger",
    "handle": "steipete",
    "id": "48a27aaa-8614-42e1-9ff1-7d7c299012b4",
    "verified": false
  },
  "skill": {
    "displayName": "Sonoscli",
    "latestVersion": "1.0.0",
    "license": "unknown",
    "name": "sonoscli",
    "ownerHandle": "steipete",
    "slug": "sonoscli",
    "stats": {
      "downloads": 85518,
      "installs": 2800,
      "stars": 56
    },
    "summary": "Control Sonos speakers (discover/status/play/volume/group).",
    "tags": [
      "other"
    ],
    "type": "skill",
    "updatedAt": "2026-07-06T10:48:38.202Z"
  },
  "sourceHandoff": null,
  "version": {
    "checksum": null,
    "checksumAlgorithm": null,
    "id": "69897909-0812-4761-9fcb-453ccd239243",
    "publishedAt": "2026-01-04T16:49:41.030Z",
    "size": null,
    "version": "1.0.0",
    "artifactStorageKey": null,
    "changelog": "",
    "manifest": {
      "clawhub": {
        "tags": {
          "latest": "1.0.0"
        },
        "owner": "steipete",
        "stats": {
          "stars": 56,
          "comments": 1,
          "installs": 2800,
          "versions": 1,
          "downloads": 85518
        },
        "topics": [],
        "categories": [
          "other"
        ]
      },
      "install": "openclaw skills install @steipete/sonoscli"
    },
    "readme": "---\nname: sonoscli\ndescription: Control Sonos speakers (discover/status/play/volume/group).\nhomepage: https://sonoscli.sh\nmetadata: {\"clawdbot\":{\"emoji\":\"🔊\",\"requires\":{\"bins\":[\"sonos\"]},\"install\":[{\"id\":\"go\",\"kind\":\"go\",\"module\":\"github.com/steipete/sonoscli/cmd/sonos@latest\",\"bins\":[\"sonos\"],\"label\":\"Install sonoscli (go)\"}]}}\n---\n\n# Sonos CLI\n\nUse `sonos` to control Sonos speakers on the local network.\n\nQuick start\n- `sonos discover`\n- `sonos status --name \"Kitchen\"`\n- `sonos play|pause|stop --name \"Kitchen\"`\n- `sonos volume set 15 --name \"Kitchen\"`\n\nCommon tasks\n- Grouping: `sonos group status|join|unjoin|party|solo`\n- Favorites: `sonos favorites list|open`\n- Queue: `sonos queue list|play|clear`\n- Spotify search (via SMAPI): `sonos smapi search --service \"Spotify\" --category tracks \"query\"`\n\nNotes\n- If SSDP fails, specify `--ip <speaker-ip>`.\n- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.\n"
  }
}

Versions

VersionSizeUpdated1.0.0Not availableJan 04, 2026