1.9k Downloads
Overview
Control a local Roon Core (music player) via Python and the Roon API, with automatic core discovery, zone selection, playback controls, and Chinese voice/command trigger support.
Key Advantages
1.Automatic Roon Core discovery and persistent token management (no repeated authorization after first run).
2.Zone selection with persistence across restarts and sensible defaults (auto-selects zones ending with specific suffix such as "muspi" or "[roon]").
3.Comprehensive basic playback control: play, pause, play/pause toggle, previous, next, and current track query.
4.Unified, structured JSON-style responses for all operations, simplifying integration into agents and tools.
5.Built-in command line interface for quick manual control and debugging outside of an agent context.
Chinese-language command triggers mapped to common playback actions, improving usability for Chinese
Use Cases
- Voice/agent-based control of a home Roon setup: play/pause, next/previous, and status queries in English or Chinese.
- Multi-room music control agents that need to switch between Roon zones (e.g., Living Room, Kitchen) and remember the last used zone.
- Smart home orchestration where music playback in a Roon ecosystem is coordinated with lighting, scenes, or routines.
- Desktop or server-side automation scripts that need simple CLI or API-style hooks to control Roon playback without manual interaction.
- Monitoring or dashboard tools that periodically query and display the currently playing track, artist, and album from a Roon Core.
Evaluation Scores
8.0
/ 10
Reliability
7.5
Functionality
8.0
Usability
8.5
Safety
8.0
Performance
8.5
Compatibility
7.5
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.0/103/19/2026▼
OS: linux-x64LLM: minimax/minimax-m2.5
**Quick judgment**
A focused and practical skill for controlling a Roon Core: it covers the essential playback and zone-management functions, has a clean API and CLI, and already shows meaningful adoption (≈1900 downloads). It’s well-suited for home automation and voice/agent control of Roon, especially in environments with Chinese-speaking users.
**Strengths**
- Handles Roon Core discovery and token persistence automatically, reducing setup friction.
- Provides all core playback controls plus current-track metadata in a structured response.
- Remembers selected zones across restarts and offers default zone selection heuristics (e.g., zones ending with a specific suffix like "muspi").
- Chinese trigger word support makes it more accessible for Chinese-language commands.
**Key risks / limitations**
- Hard dependency on a reachable Roon Core and the `roonapi` library; in environments without Roon, all operations will fail.
- Relies on naming conventions (e.g., zones ending with "muspi" or "[roon]") for auto-selection, which can cause confusion if user zones are not named accordingly.
- Stores the Roon API token in `~/clawd/roon_config.json`; while typical for such tools, it’s a credential that must be protected with proper file permissions.
- Exposes only basic playback and status features; no advanced queue management, library browsing, or search.
**Recommended scenarios**
- Home assistant / OpenClaw agents that need to control an existing Roon setup with simple commands and status queries.
- Multilingual (especially Chinese + English) voice-control systems for household media playback.
- Smart home workflows where an agent or automation script must start, pause, or skip tracks in specific Roon zones, remembering the last used zone.
Overall, this is a solid, purpose-built skill for environments that already use Roon, with low inherent safety risk but a strong dependency on local network and configuration conventions.
Comments (0)
No comments yet. Be the first!