for Apple TV

How a TV schedule works

Schedule math for people who would rather be watching. One list, one clock, and a fixed shuffle account for everything from joining in the middle to the show that starts at 8:31.

Published · Updated · By Ethercycle LLC

Tune in at 8:10 PM and the show is already 18 minutes in, while the TV in the next room shows the same frame. Both follow from a few rules. Our Chief Scheduling Officer is arithmetic, and its rules fit on one page. The shows below are invented, but the math is the same math SpiteTV for Apple TV runs on your library.

A channel is a list on a clock

Start with three shows on one channel:

ProgramLength
A sitcom30 min
A cartoon22 min
A cop show38 min

Together they run 90 minutes. Shuffle them, play them in that order, then shuffle again and play them again, forever. Each full round is a pass. Every pass is 90 minutes long, because every pass plays each program exactly once.

Now pin the first pass to a fixed moment. For this example, say the channel started at 6:00 AM today. At 8:10 PM, the clock reads 850 minutes since 6:00 AM.

  • 850 divided by 90 is 9 full passes, with 40 minutes left over.
  • So we are 40 minutes into pass number 10.
  • Say pass 10 runs the cartoon (minutes 0 to 22), the sitcom (22 to 52), the cop show (52 to 90).
  • Minute 40 falls inside the sitcom, 18 minutes in. The sitcom started at 7:52 PM and ends at 8:22 PM.

Given the list, the order, and the time, anyone can work out what is on. No server has to remember it.

SpiteTV does the same thing, with a longer list and an older starting point. Each channel's timeline is anchored at 6:00 AM local time on January 1, 2000, and has been running in passes ever since. The order of each pass comes from a fixed shuffle seeded by the channel, the pass number, and your library. The same seed always gives the same order.

Why you join in the middle

The program started without you. At 8:10 PM, the sitcom is 18 minutes in. When you select it, playback starts at minute 18, the live point. There is no start-over button and no resume prompt, because the channel is on. You can pause, and you will fall behind live. You can scrub back inside the current program. On a server stream, scrubbing stops at the point where you joined.

People say they want this: something is already on, so there is nothing to decide. It also takes a day to get used to.

Pause and "behind live"

Pause on a SpiteTV channel and you fall behind the schedule. Once you are more than 30 seconds behind, bring up the banner and it shows how far, for example "4 min behind live." When the program ends, the next one starts from its beginning, still 4 minutes behind. Leave the app and come back, and you rejoin live.

How two TVs show the same schedule

Two Apple TVs in one house, both on channel 2 at 8:10 PM, show the same sitcom at the same minute. They never talk to each other. They agree because they compute the same answer from the same inputs:

InputMust matchHow it stays matched
The channelSame channel rulesShip with the app
The date and timeSame time zone, clocks set correctlyYour Apple TVs' own clocks
Your librarySame items with the same lengthsBoth read the same Plex server
Settings that shape channelsPackages, hidden channels, kids mode, break settingsSync through your own iCloud

If one TV's clock is 3 seconds fast, its picture runs 3 seconds ahead. That is the only drift. There is no SpiteTV server keeping time, because there is no SpiteTV server.

Reorder a channel and it takes a new number, but its schedule does not move. The seed uses the channel's identity, not its number.

The broadcast day starts at 6:00 AM

Every schedule day in SpiteTV runs from 6:00 AM to 6:00 AM. A day shows every program that starts in that window. The last one runs past 6:00 AM, and the next day starts when it ends.

The reason is the midnight movie. If the day turned over at midnight, a rebuild could land in the middle of a film you are watching at 12:40 AM. At 6:00 AM, almost nobody is.

The guide shows 24 hours ahead, and SpiteTV keeps today and tomorrow ready. Days with 23 or 25 hours, when the clocks change, are handled, and a time zone change rebuilds the schedule.

True start times against quarter-hour starts

Real channels start programs on the hour and half hour. Episodes are shorter than their slots, and commercials fill the rest. Your library has no commercials in it, so SpiteTV gives you a choice.

Breaks off: true start times

This is the default. Programs run back to back, with no gap and no filler. Each starts the moment the last one ends.

StartProgramLength
7:52 PMThe sitcom30 min
8:22 PMThe cop show38 min
9:00 PMThe cartoon22 min
9:22 PMA nature show47 min
10:09 PMA teen sitcom22 min
10:31 PMA court show26 min

Start times like 10:31 are honest. Nothing is padded, and you never sit through anything you did not ask for. The guide still draws 30-minute columns and places each program at its true width.

Breaks on: quarter-hour starts

With Premium, you can turn on commercial breaks and choose a break library. Then every program's slot is its length rounded up to the next 15 minutes. Every program starts on :00, :15, :30, or :45. The same evening becomes:

StartProgramLengthSlotBreak after
7:45 PMThe sitcom30 min30 minnone
8:15 PMThe cop show38 min45 min7 min
9:00 PMThe cartoon22 min30 min8 min
9:30 PMA nature show47 min60 min13 min
10:30 PMA teen sitcom22 min30 min8 min
11:00 PMA court show26 min30 min4 min

A program that ends exactly on a quarter hour, like the sitcom, gets no break. In the app's schedule tests on 20 channels, breaks came to 12.1% of the day.

Spots and cards in a break

With breaks off, nothing does, because there is no gap.

With breaks on, spots from your break library fill each break. SpiteTV chooses them by rating, category, era, and season, so kids channels get kid-rated spots and an 80s channel gets spots from the 1980s. Inside a break, spots are picked at random until 2 minutes remain, then the last 2 minutes are packed as tightly as the library allows. Whatever is left is covered by a card: "coming up next" with the next title when 5 seconds or more remain, or the channel's ident when less does.

Two timing rules hold the quarter hours. A spot that would run more than half a second past the quarter hour does not start. A program never starts early. The breaks are part of the schedule, so every TV on the same library sees the same spots at the same time.

How often a channel repeats

Each pass plays every program once. A day repeats a program when a pass boundary falls inside it and the two passes on either side share that program.

SpiteTV measured this over 300 days:

Programs on the channelDays with a repeat, out of 300
29 hours190
37 hours106
48 hours2
81 hours or more0

Under 25 hours, a day must repeat, because the channel cannot fill 24 hours without one. From 108 hours, the app guarantees no repeat inside a day: it draws the start of the next pass first, so the day that joins two passes does not use the same program twice. Within a pass, it also avoids playing the same show twice in a row when the list allows it.

Small channels repeat, as small cable channels did. The fix is more programs that match the channel, and tagging your library is how you find them in what you already own.

When your library changes

The schedule depends on your library, so a change can move it. SpiteTV limits the damage:

  • Only channels whose list of programs changed are rebuilt. The rest keep their schedules.
  • A changed channel's new schedule comes from the new list. Add three episodes to a sitcom channel and that channel's order changes; the movie channels do not.
  • Recent additions join Fresh Tape, the channel for things added in the last 60 days, at the next 6:00 AM.
  • Changing packages, hidden channels, kids mode, or break settings rebuilds from what the app already holds, with no new read from your server. A rebuild that takes longer than about half a second shows "Rebuilding the guide."

Asked and answered

Why does the show start in the middle when I tune in?

Because the channel is live. Its schedule runs whether or not you are watching. When you tune in, the program on now starts at the point it has reached, like a real channel.

How do two Apple TVs show the same thing without a server?

Each one works out the schedule from the same three inputs: the channel, the date, and your library. Same inputs, same answer. The settings that shape channels sync through your iCloud, and both TVs need the same time zone.

Why do programs start at odd times like 8:31?

With commercial breaks off, programs run back to back at their true lengths, with no filler. A 22-minute episode that starts at 8:09 ends at 8:31, and the next one starts then.

Can I make programs start on the hour?

Yes, with Premium. Turn on commercial breaks and choose a break library. Every program then starts on :00, :15, :30, or :45, and spots from your library fill the time between.

Why did the same episode play twice today?

The channel is small. Each pass plays every item once, and a new pass starts when the last one ends. A channel with less than 25 hours of programs must repeat inside a day. Add more matching items and repeats thin out.

What happens when I pause?

You fall behind live. Bring up the banner and it shows how many minutes behind. The next program starts from its beginning, still behind by the same amount. Leave the app and come back and you rejoin live.

Keep reading

SpiteTV for Apple TV is in beta. Join the beta.

Menu

Join the beta