基于SoCo的Sonos命令行实用程序
soco-cli的Python项目详细描述
SoCo-CLI:从命令行控制Sonos系统
概述
sococli是流行的pythonsoco库[1]的强大命令行包装器,用于控制Sonos系统。SoCo CLI完全是用Python编写的,可以跨平台移植。在
提供了一个简单的sonos
命令,允许轻松控制扬声器播放、音量、组、EQ设置、睡眠计时器等。可以按顺序运行多个命令,包括在命令之间插入延迟、等待扬声器状态以及使用循环创建重复的操作序列。在
SoCo CLI的目标是一个有序的命令结构和一致的返回值,使其适合于脚本化自动化场景、cron
作业等
支持的环境
- 需要Python3.5或更高版本。在
- 在Python支持的所有平台上运行。在不同版本的Linux、macOS和Windows上进行了测试。在
- 适用于Sonos的“S1”和“S2”系统,以及分离式S1/S2系统。在
安装
使用pip install soco-cli
从PyPI安装。在
用户指南
安装程序将sonos
命令添加到路径中。所有命令的格式如下:
sonos SPEAKER ACTION <parameters>
SPEAKER
标识说话人,可以是说话人的Sonos房间名称或其IPv4地址(以点分隔的十进制格式)。请注意,扬声器名称区分大小写(除非使用完整文档中讨论的替代发现)。在ACTION
是要对扬声器执行的操作。根据操作的不同,它可以使用零个或多个参数。在
对说话人进行更改的操作通常不提供返回值。相反,可以检查程序退出代码以测试操作是否成功(退出代码0)。如果遇到错误,错误消息将被打印到stderr
,程序将返回非零退出代码。在
简单用法示例:
sonos "Living Room" volume
返回客厅扬声器的当前音量设置。在sonos Study volume 25
将Study的扬声器音量设置为25。在sonos Study group Kitchen
将Study的演讲者与Kitchen的演讲者分组。在sonos 192.168.0.10 mute
返回给定IP地址处扬声器的静音状态(“on”或“off”)。在sonos 192.168.0.10 mute on
在给定的IP地址处使说话人静音。在sonos Kitchen play_favourite Jazz24 : wait 30m : Kitchen stop
播放“Jazz24”30分钟,然后停止播放。在
有关完整文档,请参见https://github.com/avantrec/soco-cli。在
链接
[1]https://github.com/SoCo/SoCo
致谢
承认所有商标。Avantrec有限公司与Sonos公司没有任何关联
- 项目
标签: