How do I install the Wiim skill?

Run npx skillmds@latest add tomevault-io/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. 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.

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

Wiim by tomevault-io — Agent Skill

Name: Wiim
Author: tomevault-io

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. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---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. Use when this capability is needed.---# WiiM CLIControl WiiM and LinkPlay audio devices from the command line.## Installation```bash# Install globallyuv tool install wiim-cli# Or run directly without installinguvx --from wiim-cli wiim --help```Requires Python >=3.11.## Quick ReferenceAll commands accept `--host <ip>` to target a specific device. If omitted and only one device is on the network, it auto-discovers.### Discovery```bashwiim discover # Find devices on the network```### Playback```bashwiim status # Show what's playingwiim play # Resumewiim pause # Pausewiim stop # Stopwiim next # Next trackwiim prev # Previous trackwiim seek 90 # Seek to 1:30wiim shuffle true # Enable shuffle```### Volume```bashwiim volume # Show current volumewiim volume 50 # Set to 50%wiim mute # Mutewiim unmute # Unmute```### Play Media```bashwiim play-url "https://example.com/stream.mp3" # Play a URLwiim 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.).---> Converted and distributed by [TomeVault](https://tomevault.io/claim/kbarbel640-del) — claim your Tome and manage your conversions.

Frequently asked questions