SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:sonoscli 通过 sonos 命令在本地网络控制 Sonos 音箱,覆盖发现、状态查询、播放控制、音量、分组、收藏、队列与 Spotify 搜索等常见操作。

主要能力与用法: 发现与状态:sonos discover;sonos status --name "Kitchen"。 播放控制:sonos play|pause|stop --name "Kitchen"。 音量:sonos volume set 15 --name "Kitchen"。 分组:sonos group status|join|unjoin|party|solo。 收藏:sonos favorites list|open。 队列:sonos queue list|play|clear。 Spotify 搜索(经 SMAPI):sonos smapi search --service "Spotify" --category tracks "query"。

限制与排错:若 SSDP 失败,可指定 --ip <speaker-ip>。Spotify Web API 搜索为可选功能,需要 SPOTIFY_CLIENT_ID/SECRET。

discover 报 no route to host 时,在 Mac OS 直接模式(无 Docker 沙箱)下,需为 Gateway 的顶层宿主父进程开启“设置 -> 隐私与安全性 -> 本地网络”,例如通过 launchd 运行的 node、直接在终端运行的 Terminal,或在 VS Code 终端中运行时的 Visual Studio Code;也可改用允许网络访问的 Docker 沙箱。

discover 报 bind: operation not permitted 时,可能运行在 Codex 等不允许网络访问的沙箱中,需调整沙箱或批准提权请求。

适用场景:本地网络中批量或脚本化控制 Sonos 音箱。其他功能、收费与平台支持暂未提供。