roon-controller
Control Roon music player through Roon API with automatic Core discovery and zone filtering. Supports play/pause, next/previous track, and current track query. Automatically finds Muspi zones. Supports Chinese commands.
Why use this skill?
Easily control your Roon music player with the roon-controller skill. Features automatic core discovery, zone switching, and natural language command support.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/puterjam/roon-controllerWhat This Skill Does
The roon-controller is a powerful OpenClaw AI agent skill designed to bridge the gap between natural language processing and high-fidelity audio management. By integrating directly with the Roon API, this skill allows users to control their entire home audio ecosystem using voice or text commands. It automates the complex discovery process of finding your Roon Core on a local network, handles persistent authentication tokens for seamless reconnection, and provides granular control over music zones. Whether you are managing multiple speakers throughout the house or simply want to pause your music with a quick message, the roon-controller handles the technical heavy lifting, ensuring your commands are interpreted and executed instantly.
Installation
To begin using this skill, ensure you have Python 3 installed and the necessary library dependencies. First, install the core requirements via pip:
pip install roonapi
Next, install the skill package directly through the OpenClaw CLI using the following command:
clawhub install openclaw/skills/skills/puterjam/roon-controller
Once installed, the controller will automatically detect your Roon Core on the initial run. If you are prompted for authorization, look at your Roon Remote app to approve the connection. Once authorized, the token is encrypted and saved, ensuring future sessions require no further setup.
Use Cases
- Whole-Home Audio Management: Easily switch between different rooms (zones) in your house by issuing a simple voice command, making it easy to follow the music as you move from the living room to the kitchen.
- Hands-Free Playback: Perfect for times when you are cooking, working, or relaxing and do not want to reach for a phone or tablet to adjust track playback or skip a song.
- Automated Audio Context: Use the current track information in logic flows to perform secondary actions, such as updating a status board or logging your listening habits.
Example Prompts
- "Roon, pause the music in the Living Room."
- "What track is currently playing on the kitchen speakers?"
- "Switch the active zone to the Master Bedroom and play the next song."
Tips & Limitations
- Naming Conventions: For the best experience, name your Roon zones with consistent, simple names. If a zone is not explicitly selected, the skill defaults to zones suffixed with "[roon]" to help avoid accidental control of irrelevant devices.
- Network Stability: The Roon Core discovery feature requires your agent to be on the same local network subnet as your music server. Ensure your firewall settings allow communication over Roon's discovery ports.
- Persistent Configs: The skill stores your configuration in
~/clawd/roon_config.json. Do not delete this file unless you intend to re-authorize the Roon Core and re-select your preferred playback zones.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-puterjam-roon-controller": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api