A powerful command-line interface for controlling WiiM and LinkPlay audio devices across your local network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wiim
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wiim using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WiiM Audio Control?
The WiiM skill enables developers and home automation enthusiasts to manage WiiM audio hardware directly through terminal commands. By leveraging this Openclaw Skills integration, you can automate playback, adjust volume, and trigger media streams programmatically. It acts as a bridge between your local network audio hardware and your automation environment, providing a streamlined way to interact with LinkPlay-based devices without needing a mobile app.
This tool is particularly useful for those who want to integrate high-fidelity audio hardware into their technical workflows. Whether you are building a custom dashboard or simply prefer the efficiency of a CLI over a GUI, this skill provides the necessary endpoints to maintain full control over your audio environment.
WiiM Audio Control Use Cases
- Automating background music in a smart home office environment.
- Integrating WiiM device status into custom developer dashboards.
- Playing specific audio URLs or radio streams via terminal scripts.
- Controlling multi-room audio volume during specific times of the day.
- Managing playback on LinkPlay-enabled speakers without using a smartphone.
How WiiM Audio Control Works
- The skill scans the local network using SSDP and UPnP protocols to identify active WiiM or LinkPlay devices.
- Users can target specific devices using IP addresses via the --host flag or let the skill auto-discover the primary speaker.
- Commands are issued over the network to the device API to modify playback states like play, pause, or skip.
- Real-time feedback is returned to the CLI, showing current track status, metadata, and volume levels.
WiiM Audio Control Setup
Install the WiiM CLI globally using uv:
uv tool install wiim-cli
Alternatively, run it directly without installation using uvx:
uvx --from wiim-cli wiim --help
Requirements:
- Python >=3.11
- Machine must be on the same local network as the WiiM device.
WiiM Audio Control Data Schema & Taxonomy
| Property | Description | Data Type |
|---|---|---|
| host | The IP address of the targeted WiiM device | String (IP) |
| status | Current playback state (playing, paused, stopped) | String |
| volume | Current audio level from 0 to 100 | Integer |
| preset | Numerical identifier for saved media favorites | Integer |
| url | Direct link to audio stream (MP3, FLAC, M3U) | String (URL) |
WiiM Audio Control Advanced Features
- Multi-device targeting using the --host flag for complex network environments.
- Support for direct audio URL playback for custom streaming sources.
- Precise track seeking to specific timestamps.
- Preset activation for one-click access to favorite playlists or radio stations.
- Automated device discovery that simplifies setup in single-device environments.
SKILL.md
Loading
Related Openclaw Skills
Strava CLI
A powerful command-line interface for Strava that allows developers and athletes to interact with their fitness data directly from the terminal.
GEO Visual Opportunity Engine
An AI-driven automation tool that streamlines e-commerce onboarding through data synthesis, Generative Engine Optimization, and AI image generation.
YTMusic Librarian
Automate YouTube Music library management, playlist creation, and song discovery using the ytmusicapi library within your AI workflows.
LSP Python
A comprehensive Python Language Server Protocol integration providing real-time diagnostics, formatting, and intelligent code analysis for AI agents.
Norway Roads
A specialized AI skill for querying real-time Norwegian road closures and travel conditions via the official Statens Vegvesen NVDB API.
XMind Generator
A professional utility to convert Markdown outlines and plain text into structured XMind mind maps.
METADATA
Featured*
