wiim

What This Skill Does

The wiim skill provides a comprehensive interface for controlling WiiM and LinkPlay-based audio hardware directly through your terminal or via the OpenClaw agent. It bridges the gap between software commands and physical audio playback, enabling precise control over media state, volume, and source selection. Whether you need to pause your music, adjust the volume level of a multi-room setup, or trigger a specific saved preset, this skill handles the heavy lifting of network discovery and command transmission. It is an essential tool for users seeking to integrate their high-fidelity audio equipment into an automated agent workflow.

Installation

To integrate the wiim skill into your environment, utilize the OpenClaw installation command. Ensure your system meets the requirement of Python 3.11 or higher. You can install it by running:

clawhub install openclaw/skills/skills/geodeterra/wiim

For local development or command-line testing, ensure the wiim-cli package is accessible. You can install it globally via uv tool install wiim-cli or execute it directly using uvx --from wiim-cli wiim. Ensure your machine is on the same local area network as your audio devices for seamless communication.

Use Cases

• Home Automation: Integrate your audio system into complex routines, such as silencing speakers when a phone call arrives or starting a preset playlist when you arrive home.
• Quick Media Control: Rapidly toggle playback or skip tracks without needing to navigate through manufacturer-specific applications.
• Network Audio Management: Quickly discover and verify the status of multiple LinkPlay devices on your home network.
• Stream Integration: Programmatically trigger specific web radio stations or audio streams using the play-url functionality.

Example Prompts

1. "WiiM, set the volume in the living room to 30% and skip to the next track."
2. "Check the current playback status on my WiiM device and mute it if something is playing."
3. "Start my morning preset on the WiiM speaker."

Tips & Limitations

• Network Connectivity: Because the skill relies on SSDP/UPnP for device discovery, it requires the host machine and the speakers to be on the same broadcast domain (subnet). It will not function across different VLANs.
• Service Limitations: While this skill excels at transport control, it does not manage internal streaming service authentication (e.g., Spotify login). You must initiate those streams via the native app; the skill will then take over transport controls like pause, play, and volume.
• URL Support: Ensure the URLs provided to play-url are direct links to valid audio formats (MP3, FLAC, or M3U streams) to guarantee successful playback.