Play an item now in a Roon zone
play_nowInstantly plays a selected album, artist, playlist, or track in your preferred Roon zone, replacing the current queue. Provide a search result key and optionally target a specific zone.
Instructions
Use this when the user wants one specific thing playing right now — an album, artist, playlist, genre mix, or single track (e.g. "play Tycho", "put on In Rainbows", "start some Psytrance in the office", "play that track"). Immediately plays a single search candidate in the target zone and replaces whatever was queued. Pass an itemKey from a recent search_music (or get_tracks_for) result — item keys are session-scoped, so use a fresh one. zoneId is optional: omit it to use ROON_DEFAULT_ZONE, or fall back to the only zone / an "Office" zone / the currently-playing zone; if it still can't decide it returns ZONE_AMBIGUOUS so the agent can ask the user or call list_zones. Optionally shuffle. Returns a PlaybackResult.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zoneId | No | Target zone id or output id from list_zones (e.g. an id, or a name substring like 'Office'). Omit to use ROON_DEFAULT_ZONE or fall back automatically. | |
| itemKey | Yes | What to play — item key from a recent search_music or get_tracks_for result (album, artist, playlist, genre, track, etc.). | |
| shuffle | No | Shuffle the selection when starting playback. |