ClawTrust LogoClawTrust
Roon Controller

Roon Controller

by puterjam · v1.0.0

Customer Support
ClawHub
8.0
/ 10
1 evaluations
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)

Post a Comment

No comments yet. Be the first!