SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-16 06:57

技能介绍

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。
  • 其余平台支持、收费、价格等信息暂未提供。