AGENT SKILL

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
所属仓库
paraseva/swarpius
最近更新
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. Requires zone.
  • 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. Requires alias (the friendly name) and zone (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. Requires alias (current name) and new_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. Requires zone (source) and zone_to_transfer_to (target). Does not change the default zone — use Set Default Zone separately if the user also wants to change their default.

Zone grouping

  • Group Zones groups two or more zones to play in sync. Requires group_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 Zones breaks a group. Provide zone (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 Groups lists 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

paraseva
paraseva/swarpius

web-search

Search the public web for facts, context, and references. Use for information that cannot be retrieved from a Roon Search.

★ 1
paraseva
paraseva/swarpius

roon-status

Read-only Roon state: zone status with seek position, queue track listing with references.

★ 1
paraseva
paraseva/swarpius

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.

★ 1
paraseva
paraseva/swarpius

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.

★ 1
paraseva
paraseva/swarpius

result-fetch

Retrieve cached items by result_handle (format: res_NNNNN) from the search_history section. Only use handles listed in search_history.

★ 1
paraseva
paraseva/swarpius

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.

★ 1