roon-config
Manage Roon zone configuration: set/get default zone, manage zone aliases (set, remove, rename, list, clear), group/ungroup zones, transfer playback between zones.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-09
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- roon-config
- description
- Manage Roon zone configuration: set/get default zone, manage zone aliases (set, remove, rename, list, clear), group/ungroup zones, transfer playback between zones.
- requires_tool
- roon_config
03 SKILL.md 正文
Default zone
Set Default Zone— set the default zone for all operations when no zone is specified. Requireszone.Get Default Zone— returns the current default zone.
Zone aliases
Zone aliases attach a friendly name to a zone. Aliasing a grouped zone isn't supported in this version.
Set Zone Alias— alias a zone. Requiresalias(the friendly name) andzone(the zone to alias). The alias name itself must not match any existing zone name.Remove Zone Alias— remove an alias by its name.Rename Zone Alias— rename an alias. Requiresalias(current name) andnew_name.Get Zone Aliases— list all aliases with their zone names.Clear All Zone Aliases— remove every alias.
Transfer
Transfer Zone— transfer playback from one zone to another. Requireszone(source) andzone_to_transfer_to(target). Does not change the default zone — useSet Default Zoneseparately if the user also wants to change their default.
Zone grouping
Group Zonesgroups two or more zones to play in sync. Requiresgroup_zones(list of zone names, minimum 2). The first listed zone becomes the primary (its queue is preserved). Grouped zones display under Roon's default name (e.g.MDAC+ USB + 1); they can't be aliased directly.Ungroup Zonesbreaks a group. Providezone(the grouped zone's display name like "A + 1", or any member's name, or an alias of a member). All members are ungrouped.Get Groupslists all currently grouped zones.- Grouping a zone that's already in another group pulls it (and any other members requested) into the new group.
- Groups created in other Roon clients (desktop app, etc.) are fully visible and manageable.
04 同仓库更多 Skills
web-search
Search the public web for facts, context, and references. Use for information that cannot be retrieved from a Roon Search.
roon-status
Read-only Roon state: zone status with seek position, queue track listing with references.
roon-search
Browse and search the Roon music library one level at a time. Roon text search fuzzy-matches specific titles and names in the following categories: Tracks, Albums, Artists, Playlists, Composers, Works. For vague or genre-based requests, either use your own knowledge or use web_search to retrieve needed information.
roon-action
Control Roon playback: play/queue/shuffle/start radio for media, transport (pause, stop, next, previous), playback settings (shuffle, repeat, seek, auto-radio), volume, mute, mute all, standby, and play from a specific queue position. Library actions require a `reference` from a prior roon_search result. For zone grouping, use the roon_config tool instead.
result-fetch
Retrieve cached items by result_handle (format: res_NNNNN) from the search_history section. Only use handles listed in search_history.
listening-history
Look up what music was played and when, across zones, by date/time range. Use today's date from the prompt to resolve relative ranges ("last Tuesday", "this morning", "yesterday evening"). This is the historical record — distinct from roon_status, which reports what is playing now or the last track in a zone.