How do I install the Wiim skill?

Run npx skillmds@latest add dvcrn/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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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.

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

Wiim by dvcrn — Agent Skill

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

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.

dvcrn Updated Sep 8, 2026 32 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.).

Frequently asked questions