Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub · Developer Tools
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.
skill openclawclawhub Free
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.
⬇ 0 downloads ★ 0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- requirements.txt, SKILL.md, roon_controller.py
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.3
Provenance
- Publisher
- puterjam
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Roon Control Skill
Control the Roon music player with Chinese command support.
Install Dependencies
pip install roonapi
Usage Examples
from roon_controller import RoonController # Create controller (token will be saved automatically) controller = RoonController(verbose=True) # Play/Pause result = controller.play_pause() # Next track result = controller.next() # Get current track track_info = controller.get_current_track() print(f"Now playing: {track_info['track']}")
1. Automatic Discovery and Connection
Automatic Roon Core discovery Token automatically saved to ~/clawd/roon_config.json Auto-reconnect after restart, no re-authorization needed
2. Zone Selection and Switching
Supports switching between any available zone Selected zone is saved in config and persists across restarts If no zone is selected, defaults to zones ending with "[roon]" Use set_zone() to switch zones programmatically Switch Zone result = controller.set_zone("Living Room") # {"success": True, "message": "Switched to zone: Living Room", "zone": "Living Room"} Get Current Zone zone = controller.get_current_zone() # Returns zone info dict with zone_id and zone_data
3. Playback Control
Play result = controller.play() # {"success": True, "message": "Playback started", "zone": "Living Room Muspi"} Pause result = controller.pause() # {"success": True, "message": "Paused", "zone": "Living Room Muspi"} Play/Pause Toggle result = controller.play_pause() Previous Track result = controller.previous() Next Track result = controller.next()
4. Get Current Track
track_info = controller.get_current_track() # Returns: # { # "success": True, # "is_playing": True, # "zone": "Living Room Muspi", # "track": "Bohemian Rhapsody", # "artist": "Queen", # "album": "A Night at the Opera", # "seek_position": 12345, # milliseconds # "length": 354000 # milliseconds # }
5. List All Zones
zones = controller.list_zones() # ["Living Room Muspi", "Kitchen", "Bedroom"]
Command Line Tool
The script can be used as a command line tool: # Play python roon_controller.py play # Pause python roon_controller.py pause # Previous track python roon_controller.py prev # Next track python roon_controller.py next # View current track python roon_controller.py status # List all zones python roon_controller.py zones -v # switch zone python roon_controller.py switch zonename
Chinese Command Support
The skill supports the following Chinese trigger words: CommandMeaningExample音乐播放 / 播放音乐Start playback"音乐播放"暂停 / 暂停播放Pause playback"暂停一下"下一曲 / 切歌Next track"下一曲"上一曲Previous track"上一曲"当前曲目 / 正在放什么View current track"当前曲目"
Error Handling
All methods return a unified dictionary structure: { "success": True/False, "message": "Operation result description", "zone": "Zone name (optional)" }
Common Errors
Muspi zone not found: Check if the Roon zone name ends with "muspi" Failed to connect to Roon: Ensure Roon Core is running and network-accessible Token load failed: First run requires authorization, ensure authorization completes successfully
Notes
First Run: Extension authorization required in Roon, check for the extension authorization prompt in Roon interface Zone Naming: Muspi zone names must end with "muspi" (case-insensitive) Token Storage: Token is saved in ~/clawd/roon_config.json, ensure secure file permissions Network Requirements: The device running the script must be on the same network as Roon Core
Dependencies
roonapi>=0.1.6: Official Roon API Python library
Token Management
Token storage path: ~/clawd/roon_config.json Auto-load: Automatically loaded on each startup Auto-save: Automatically saved on first authorization or update
Zone Finding Algorithm
# Find all zones zones = roon.zones # Filter zones with muspi suffix muspi_zones = [ (zone_id, zone_data) for zone_id, zone_data in zones.items() if zone_data['display_name'].lower().endswith('muspi') ] # Use the first matching zone zone_id, zone_data = muspi_zones[0]
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts1 Files
- SKILL.md
- roon_controller.py
- requirements.txt