Sonos CLI 是一个通过命令行控制本地网络中 Sonos 音箱的工具。
用途 用于在同一局域网内对 Sonos 音箱执行常用控制操作,包括发现设备、查看状态、控制播放以及调整音量与分组。
主要能力
- 设备发现: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"
使用方式 在本地网络环境中通过终端调用 sonos 命令,按功能选择对应子命令,并通过 --name 指定目标音箱名称。常用快速入门命令包括: sonos discover sonos status --name "Kitchen" sonos play|pause|stop --name "Kitchen" sonos volume set 15 --name "Kitchen"
适用场景 适合需要在局域网内以脚本或命令行方式操作 Sonos 音箱、执行播放控制、音量调节、分组、收藏与队列管理的使用场景。
限制与注意事项
- 若 SSDP 发现失败,可通过 --ip <speaker-ip> 指定音箱 IP。
- Spotify Web API 搜索为可选功能,需要配置 SPOTIFY_CLIENT_ID/SECRET。
- 其余平台支持、收费、价格等信息暂未提供。