How do I install the Wiim skill?

Run npx skillmds add modbender/wiim in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wiim?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wiim by modbender — Agent Skill

Name: Wiim
Rating: 4.2 (5 reviews)
Author: modbender

Wiim

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.

modbender 9b943ce 1.9 KB Updated Sep 9, 2026 12 repo stars

File contents

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-url works with direct audio URLs (MP3, FLAC, M3U streams, etc.).

---name: wiimdescription: 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 ```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.).

Frequently asked questions