for Apple TV

Set up commercial breaks

Checked against version 0.1.0 · Updated

Put your commercials, promos, and bumpers in their own Plex library, then pick it as the break library in Settings.

Commercial breaks are part of Premium in SpiteTV for Apple TV. They play items from one Plex library that you choose, the break library. Turn on Commercial Breaks and pick a Break Library in Settings > Channels. The app ships no clips, and SpiteTV hosts none. You bring your own.

What the break library should hold

  • Short clips: commercials, promos, public service spots, bumpers, and station IDs. Anything in the library can play in a break.
  • It must be a movie or TV library on the same Plex server as your channels. The break library list shows the same movie and TV libraries as Settings > Plex > Libraries.
  • Leave out anything you want on a channel. Items in the break library never appear on channels.
  • Tags are optional. A spot's Plex genres tell the app its kind, its category, and any holiday. Its year and content rating come from Plex too. See Tagging spots. Untagged spots still play.

For where clips come from and how to cut and tag them, see Build a break library. For how to add a library on the server, see Plex's own documentation.

Steps

  1. In Plex, make a library that holds only your break clips. Name it "Commercials" if you like (see below).
  2. In SpiteTV, open the sidebar and select Settings.
  3. Select Channels.
  4. Select Commercial Breaks to turn it On. Its help reads "Plays items from a Plex library between programs." It is off by default.
  5. Select Break Library. The page Commercial Break Library opens: "Select the library whose items play between programs."
  6. Pick your library. Its help reads "Plays this library's items during breaks instead of on channels." None "Plays nothing during breaks."

The guide rebuilds. Programs now start on the quarter hour, and breaks fill the gaps. See How breaks work.

Mock-up. Settings, as the app lays them out.

The Commercials shortcut

If your server has a library named "Commercials" (any capitals), and you have never set the break switch or the break library, SpiteTV picks that library and turns breaks on by itself. Any choice you make later wins, and the shortcut never runs again.

What you see in Settings

  • Break Library shows the library name, None, or Not connected when the chosen library is not on the current server.
  • In Settings > Plex > Libraries, the break library shows Breaks: "Plays during commercial breaks, so it feeds no channel."

On Free

On Free both rows show a lock. Commercial Breaks reads Off, Break Library reads Premium, and both open the Premium screen titled "Commercial breaks are part of Premium". On Free the app does not read the break library, and it still keeps that library's items off your channels. Programs run back to back at their true start times.

Prompts for an AI assistant

Paste one of these into an AI assistant. Each prompt states its own rules. You supply files you have the right to use. The prompt that drafts tags is in Tagging spots.

Plan folders and file names:

Help me plan folders and file names for a Plex library of old commercials.
Rules:
- It is one movie or TV library that holds only short clips: commercials, promos, public service spots, bumpers, and station IDs.
- Put the brand, the product, and the year the spot first aired in every file name.
- Do not download or source ads. I supply the files.
- Ask me before any change to my files.

Write a rename script with a dry run:

Write a script that renames a folder of ad files to this scheme: <your scheme>.
Rules:
- The default is a dry run. It prints each old and new name and changes nothing.
- It renames only with an apply flag, and it never overwrites a file.
- It reports every file it could not parse.
- Do not download or source ads. Ask me before you run it on my files.

Check a listing for a missing rating or year:

Below is a listing of my Plex commercials library with each spot's year and content rating. List every spot with no rating, then every spot with no year. Report only. Do not download or source ads. Ask me before any change to my files or to Plex.

<paste the listing here>

If it does not work

  • Programs still start at odd times like 8:31. Breaks are off, you are on Free, or the break library has no usable spot. A spot can be ruled out on every channel, for example when all spots are rated TV-MA.
  • A channel runs back to back while others break. That channel's rules leave no spot. For example, kids channels take only spots rated TV-Y, TV-Y7, TV-G, or G. See How breaks work.
  • Break Library says "Not connected". The library is on a different server. Pick a library again.
  • The library you want is not in the list. Only movie and TV libraries are listed. Make the break library one of those types in Plex.

Questions

Does SpiteTV come with commercials?

The app ships no clips. Breaks play items from a Plex library you build and pick. Our break library guide covers where clips come from.

Do break items also show up on channels?

The break library plays only in breaks. It never feeds a channel, on Free or Premium.

Was something wrong? Email support and we fix the page.

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

Menu

Join the beta