roon

Control Roon playback, queues, and multi-zone operations via REST API.

5|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/andyrat33/roon-controller --skill roon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roon
Source: https://github.com/andyrat33/roon-controller/tree/main/cowork-skill/roon
Command: npx skills add https://github.com/andyrat33/roon-controller --skill roon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns natural-language music requests into direct control of a Roon system, removing the need to manually search, queue, and manage playback across rooms.

Core Features & Use Cases

  • Library Search and Playback: Find songs, albums, artists, and TIDAL content, then play them in the right zone.
  • Queue and Playlist Control: Add tracks to the queue, build ordered playlists, clear queues, and start album playback natively.
  • Multi-Room Management: Mute, pause, group, ungroup, transfer, and adjust volume across multiple zones.
  • Use Case: Ask for “play something relaxing in the kitchen,” “skip this track,” or “move the music upstairs,” and the Skill handles the Roon command end to end.

Quick Start

Tell the assistant which zone to use and what music action you want, and it will connect to your Roon API to play, queue, or control playback for you.

Frequently Asked Questions about roon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Roon music playback using natural language commands?

You can control Roon music playback by issuing natural language requests to an assistant connected to a Roon REST API, which translates your commands into transport controls, volume changes, and track skipping across your zones.

Can I manage Roon multi-room zones and transfer playback hands-free?

Yes, you can manage Roon multi-room zones hands-free by requesting the assistant to group, ungroup, mute, or transfer active playback between different rooms using the connected REST API.

What do I need to set up before using voice commands with my Roon library?

You need a Docker-hosted REST API integration with specific zone identifiers configured to execute Roon actions reliably, ensuring exact action labels are matched for album-level playback.

Does Roon API search support both local library tracks and TIDAL streaming content?

Yes, Roon API search supports both local library tracks and TIDAL streaming content, allowing you to find songs, albums, and artists, then play them directly in your designated zone.

How do I build a queue and add tracks to a playlist in Roon via an assistant?

You can build a queue in Roon by instructing the assistant to add tracks to the queue, build ordered playlists, clear existing queues, and start album playback natively through the API.