WiiM CLI

从命令行控制WiiM和LinkPlay音频设备。

安装

bash

全局安装

或直接运行，无需安装

需要Python >=3.11。

快速参考

所有命令均可使用--host 指定目标设备。如果省略此参数且网络中仅有一台设备，则会自动发现。

设备发现

bash
wiim discover # 查找网络中的设备

播放控制

bash
wiim status # 显示当前播放内容
wiim play # 恢复播放
wiim pause # 暂停
wiim stop # 停止
wiim next # 下一曲
wiim prev # 上一曲
wiim seek 90 # 跳转到1分30秒
wiim shuffle true # 启用随机播放

音量控制

bash
wiim volume # 显示当前音量
wiim volume 50 # 设置为50%
wiim mute # 静音
wiim unmute # 取消静音

播放媒体

bash
wiim play-url https://example.com/stream.mp3 # 播放URL
wiim play-preset 1 # 播放已保存的预设#1

注意事项

• - WiiM必须与运行CLI的机器处于同一本地网络。
• 设备发现使用SSDP/UPnP协议——可能无法跨子网/VLAN工作。
• Spotify、AirPlay及其他流媒体服务需通过各自的应用控制。一旦在WiiM上开始播放，此CLI可执行暂停/播放/跳转/调节音量等操作。
• play-url支持直接音频URL（MP3、FLAC、M3U流等）。