✓ Verified ✍️ Content Creation ✓ Enhanced Data

Wiim

Control WiiM audio devices (play, pause, stop, next, prev, volume, mute, play URLs, presets)

Rating: 5 (216 reviews)
Downloads: 3,948 downloads
Version: 1.0.0

Overview

Control WiiM audio devices (play, pause, stop, next, prev, volume, mute, play URLs, presets)

Complete Documentation

View Source →

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 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.).

Installation

Terminal bash


openclaw install wiim

Copied!

💻Code Examples

uvx --from wiim-cli wiim --help

uvx---from-wiim-cli-wiim---help.txt

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

example.sh

# Install globally
uv tool install wiim-cli

# Or run directly without installing
uvx --from wiim-cli wiim --help

example.sh

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

example.sh

wiim volume                      # Show current volume
wiim volume 50                   # Set to 50%
wiim mute                        # Mute
wiim unmute                      # Unmute