wiim
控制 WiiM 音频设备（播放、暂停、停止、下一个、上一个、音量、静音、播放 URL、预设）。当用户想要控制音乐播放、调节音量、发现网络上的 WiiM/LinkPlay 扬声器或从 WiiM 设备上的 URL 播放音频时使用。
安装 / 下载方式
TotalClaw CLI推荐
totalclaw skills install shop:totalclaw:totalclaw~geodeterra-wiimcURL直接下载，无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~geodeterra-wiim/file -o geodeterra-wiim.md# WiiM CLI Control WiiM and LinkPlay audio devices from the command line. ## Installation ```bash # Install globally uv tool install wiim-cli # Or run directly without installing uvx --from wiim-cli wiim --help ``` Requires Python >=3.11. ## Quick Reference All commands accept `--host <ip>` to target a specific device. If omitted and only one device is on the network, it auto-discovers. ### Discovery ```bash wiim discover # Find devices on the network ``` ### Playback ```bash wiim status # Show what's playing wiim play # Resume wiim pause # Pause wiim stop # Stop wiim next # Next track wiim prev # Previous track wiim seek 90 # Seek to 1:30 wiim shuffle true # Enable shuffle ``` ### Volume ```bash wiim volume # Show current volume wiim volume 50 # Set to 50% wiim mute # Mute wiim unmute # Unmute ``` ### Play Media ```bash wiim play-url "https://example.com/stream.mp3" # Play a URL wiim play-preset 1 # Play saved preset #1 ``` ## Notes - The WiiM must be on the same local network as the machine running the CLI. - Discovery uses SSDP/UPnP — may not work across subnets/VLANs. - Spotify, AirPlay, and other streaming services are controlled from their own apps. Once playing on the WiiM, this CLI can pause/play/skip/adjust volume. - `play-url` works with direct audio URLs (MP3, FLAC, M3U streams, etc.). --- ## 中文说明 # WiiM CLI 从命令行控制 WiiM 和 LinkPlay 音频设备。 ## 安装 ```bash # Install globally uv tool install wiim-cli # Or run directly without installing uvx --from wiim-cli wiim --help ``` 需要 Python >=3.11。 ## 快速参考 所有命令都接受 `--host <ip>` 以指定目标设备。如果省略且网络上只有一台设备，则会自动发现。 ### 发现 ```bash wiim discover # Find devices on the network ``` ### 播放 ```bash wiim status # Show what's playing wiim play # Resume wiim pause # Pause wiim stop # Stop wiim next # Next track wiim prev # Previous track wiim seek 90 # Seek to 1:30 wiim shuffle true # Enable shuffle ``` ### 音量 ```bash wiim volume # Show current volume wiim volume 50 # Set to 50% wiim mute # Mute wiim unmute # Unmute ``` ### 播放媒体 ```bash wiim play-url "https://example.com/stream.mp3" # Play a URL wiim play-preset 1 # Play saved preset #1 ``` ## 说明 - WiiM 必须与运行 CLI 的机器处于同一本地网络。 - 发现使用 SSDP/UPnP —— 可能无法跨子网/VLAN 工作。 - Spotify、AirPlay 及其他流媒体服务由它们各自的应用控制。一旦在 WiiM 上开始播放，本 CLI 即可暂停/播放/跳过/调节音量。 - `play-url` 适用于直接音频 URL（MP3、FLAC、M3U 流等）。