Custom Shows let you take any collection of videos — regardless of their origin or metadata — and present them to Tunarr’s scheduling engine as if they were a single, cohesive TV series. Where a normal show’s episodes come pre-organized by season and episode number from your media source, a Custom Show lets you define that structure yourself. You pick the videos, you set the order, and Tunarr’s scheduling tools honor that ordering for episode progression, just as they would for any regular show.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chrisbenincasa/tunarr/llms.txt
Use this file to discover all available pages before exploring further.
Custom Shows will be renamed to Playlists in an upcoming release. The underlying functionality remains the same.
Use Cases
Custom Shows are particularly useful for content that doesn’t fit neatly into a traditional series structure:- YouTube channels — Group downloaded videos from a creator into a single “show” with consistent episode progression.
- Documentary series — Combine loosely related documentaries into a thematic block that cycles through them in order.
- Home videos — Organize personal recordings into a custom series for scheduled playback.
- Compilation playlists — Mix clips from multiple sources into one coherent sequence.
Creating a Custom Show
Create a new show
Click New to open the creation form. Enter a name for the show — for example, Tech Reviews 2024 or Family Vacation Videos.
Add episodes
Click Add Media. Browse your connected media sources and select the videos you want to include. You can pull content from any source — Plex libraries, Jellyfin libraries, or local files — and mix them freely within a single Custom Show.
Arrange the order
Drag and drop the added items to set the episode order. Tunarr uses this order when advancing through episodes during scheduled playback.
How Scheduling Treats Custom Shows
Once created, a Custom Show behaves identically to a standard library show inside the Slot Editor and Time Slot Editor. You can:- Assign it to a time slot and control episode advancement (play in order, shuffle, etc.).
- Use it alongside regular shows in the same channel schedule.
- Resume from where the last scheduled playback left off, maintaining proper episode progression.
External Sync
Custom Shows can be linked to an external playlist from a connected media source. When sync is enabled, Tunarr automatically keeps the Custom Show’s content in step with the upstream playlist — no manual updates required.Supported Sources
| Source | Playlist Type |
|---|---|
| Plex | Playlists |
Setting Up Sync
Choose a media source
Select the media source (currently Plex only) that hosts the playlist you want to sync from.
Manual Sync
On any synced Custom Show, click Sync Now to trigger an immediate sync. The timestamp of the last successful sync is shown next to the button.While a Custom Show is linked to an external playlist, its content is read-only. The Add Media button and drag-to-reorder controls are hidden. To manage content manually, disable the sync toggle and save the show.