Skip to main content

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.

Tunarr includes four lighter-weight scheduling and utility tools that complement the Slot Editor and Time Slots editors. Block Shuffle and Cyclic Shuffle are simplified approaches to randomized or rotating playback that don’t require configuring individual slots. Replicate and Consolidate are utility operations that help you manipulate an existing lineup — extending it or tidying up fragmented flex time. All four tools are available under the Tools menu on your channel’s programming page.

Choosing a Tool

GoalRecommended Tool
Mimic traditional TV with set air timesTime Slots
Random variety with full duration controlSlot Editor
Simple random playback with no slot configBlock Shuffle
Predictable rotation through all contentCyclic Shuffle
Extend a schedule before applying other toolsReplicate
Clean up fragmented flex timeConsolidate

Block Shuffle

Block Shuffle is a simplified version of the Slot Editor that randomly arranges programming in consecutive blocks of episodes. Rather than building a detailed slot configuration, you set a single program count and let Tunarr randomize the order. It’s the fastest way to get a varied, randomly ordered channel up and running.

How It Works

Block Shuffle plays a specific number of episodes from one show, moves on to the next show, plays the same number of episodes from that show, and so on. The order in which shows are selected is random, but within each block, episodes are played in sequence. When a show exhausts all of its episodes, it is absent from the schedule until all other shows have also completed airing — at which point the entire schedule repeats from the beginning.This “wait for others” behavior means that as you approach the end of a schedule cycle, one or two shows with longer runtimes or more episodes may temporarily dominate the lineup before the rest catch up.

Perfect Schedule Loop

To prevent late-cycle dominance by long-running shows, enable Make perfect schedule loop. This option attempts to have all shows complete their episode lists at the same time, producing a cleaner, more balanced schedule loop.
The perfect schedule loop option does not currently support larger channels. If your channel has too many episodes, Tunarr will display an error indicating the feature is unavailable. In that case, use the Loop Short Programs option instead to handle shows with fewer episodes.

When to Use Block Shuffle

Good fit

You want a randomly ordered mix of shows with no fine-grained control over timing, weighting, or filler.

Not a good fit

You need weighted playback, cooldowns, per-slot filler, or fixed start times. Use the Slot Editor or Time Slots instead.

Using Block Shuffle

1

Open Block Shuffle

Go to your channel’s programming page, click Tools, and select Block Shuffle.
2

Set the program count

Enter the number of consecutive episodes to play from each show before moving to the next. A count of 1 means the scheduler alternates one episode per show (equivalent to Cyclic Shuffle).
3

Enable looping options (optional)

If you want all shows to finish at the same time, enable Make perfect schedule loop. If your channel is too large for that option, enable Loop Short Programs instead.
4

Apply

Click Save or Apply to generate and write the new lineup to the channel.

Slot Editor

Build duration-based programming blocks with full filler and weighting control.

Time Slots

Pin programs to specific air times for a traditional TV guide experience.

Mid-Roll Breaks

Insert commercial breaks within programs using Mid filler.

Concepts

Review core scheduling vocabulary before using these tools.

Build docs developers (and LLMs) love