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.

Security Scan

The skill's instructions and requirements are consistent with a CLI that discovers and controls WiiM/LinkPlay speakers on the local network; nothing requested or described is disproportionate to that purpose.

Purpose & Capability

Name/description match the SKILL.md: it documents a wiim-cli tool to discover/control WiiM/LinkPlay speakers (play/pause/volume/discover/play-url). No unrelated env vars, binaries, or config paths are requested.

Instruction Scope

Runtime instructions are limited to installing/running a wiim-cli and using SSDP/UPnP discovery or specifying a host. The steps stay within the stated purpose. Note: play-url causes the device to fetch remote audio URLs (expected for this capability).

Install Mechanism

This is an instruction-only skill (no install spec in the registry). SKILL.md tells users to install via 'uv tool install wiim-cli' or run with 'uvx --from wiim-cli'; that implies fetching third-party code at runtime—normal for CLI usage but verify the package source before installing.

Credentials

No environment variables, credentials, or config paths are requested. The only required access is local network/SSDP (appropriate for device discovery/control).

Persistence & Privilege

always is false and there is no install-time persistence declared. The skill does not request elevated or persistent privileges.

Assessment

This skill appears coherent for controlling WiiM speakers. Before installing or running the referenced wiim-cli: verify the wiim-cli package/source (PyPI/GitHub or vendor site) so you know what code will run on your machine; be aware discovery uses SSDP/UPnP (local network traffic) and 'play-url' will make the speaker fetch remote audio—avoid playing untrusted URLs. If you want extra caution, inspect the wiim-cli source code or run it in a sandboxed environment. If you rely on corporate network policies, check that SSDP/UPnP is allowed.

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