- name
- wiim
- description
- Control WiiM audio devices (play, pause, stop, next, prev, volume, mute, play URLs, presets). Use when the user wants to control music playback, adjust volume, discover WiiM/LinkPlay speakers on the network, or play audio from a URL on a WiiM device.
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 --helpRequires 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 networkPlayback
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 shuffleVolume
wiim volume # Show current volume
wiim volume 50 # Set to 50%
wiim mute # Mute
wiim unmute # UnmutePlay Media
wiim play-url "https://example.com/stream.mp3" # Play a URL
wiim play-preset 1 # Play saved preset #1Notes
- 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.).