OpenClaw · Skill
Wiim
Control WiiM and LinkPlay audio devices from the command line.
Media & Streaming
v0.1.1
VirusTotal: Benign
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install geodeterra/wiimClawHub installer
npx clawhub@latest install geodeterra/wiimOpenClaw CLI
openclaw skills install geodeterra/wiimDirect OpenClaw install
openclaw install geodeterra/wiimWhat this skill does
Control WiiM and LinkPlay audio devices from the command line.
Why it matters
Enables scriptable, keyboard-driven audio control without switching to a phone or GUI app.
Typical use cases
- Pausing music on a WiiM speaker from a terminal session
- Adjusting volume on a network speaker without reaching for a phone
- Playing a podcast or radio stream URL on a WiiM device
- Skipping tracks while working in a terminal workflow
- Discovering all WiiM speakers on a home or office network
Source instructions
WiiM CLI
Control WiiM and LinkPlay audio devices from the command line.
Installation
# 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
wiim discover # Find devices on the network
Playback
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
wiim volume # Show current volume
wiim volume 50 # Set to 50%
wiim mute # Mute
wiim unmute # Unmute
Play Media
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-urlworks with direct audio URLs (MP3, FLAC, M3U streams, etc.).