for Apple TV

Tagging spots

Checked against version 0.1.0 · Updated

SpiteTV reads each spot's Plex genres for its kind, category, and holiday, and its Plex year and rating for the era and ratings rules.

SpiteTV for Apple TV reads a spot's tags from Plex. Genres give the spot's kind, its category, and any holiday. The Plex year places the spot in an era. The Plex content rating decides which channels may play it. You set all of these in Plex. The app ships no list of spots and no tags of its own.

The genre convention

Give each spot these Plex genres:

TagExampleRequiredWhat the app does with it
A kindCommercial, Promo, PSA, BumperNoNothing for choice. It labels the clip for you.
One categoryToys & Games, Cars, RestaurantsNoKids and alcohol rules read it.
Holiday flagsHoliday: ChristmasNoHoliday channels and seasons read it.

Case and outer spaces do not matter. "toys & games" matches "Toys & Games". A genre that starts "Season:" is skipped for now.

Category examples from the app's own notes: "Toys & Games", "Video Games", "Kids Food", "Food & Drink", "Restaurants", "Cars", "Movies & Home Video", "TV Promos", "Beer & Alcohol". Any other genre also counts as a category.

Categories the rules look for

  • Toys & Games, Video Games, Kids Food: kids and cartoon channels fill about 70% of each break from these.
  • Beer & Alcohol: never plays on kids and cartoon channels. It can play on other channels at any hour.

Holiday flags

Write the flag as Holiday: <name>. The app knows these holidays and their seasons on regular channels:

FlagPlays on other channels
Holiday: Christmas (or Xmas)Nov 1 to Dec 31
Holiday: HalloweenOct 1 to Oct 31
Holiday: ThanksgivingNov 1 to 3 days after US Thanksgiving
Holiday: Valentine'sFeb 1 to Feb 14
Holiday: New YearDec 26 to Jan 1
Holiday: Easter21 days before Easter to the day after
Holiday: Independence Day (or Fourth of July)Jun 20 to Jul 5
Holiday: St. Patrick's DayMar 1 to Mar 17

On its own holiday channel, a flagged spot can play at any date the channel is on, and fills up to half of each break. A flag that is not in this table plays only on a matching holiday channel.

Year

The app reads the spot's year from Plex. It prefers spots within 2 years of the program's year, then within 5, then any year. Decade channels play spots from their own years when your library has some. Set the year in Plex to the year the spot first aired.

Rating

  • Spots rated TV-MA, R, NC-17, or X play only on After Dark channels.
  • Kids and cartoon channels take only TV-Y, TV-Y7, TV-G, or G. On those channels an unrated spot is left out, unless no spot in your library has a rating at all.
  • Elsewhere unrated spots play.

Length

Spot lengths round up to whole seconds. Keep each spot its true length. The app packs the break itself.

Steps

  1. In Plex, open each spot's metadata. See Plex's own documentation for editing genres, year, and content rating.
  2. Add one kind, one category, and any holiday flags as genres.
  3. Set the year and the content rating.
  4. Open SpiteTV. It reads the change at its next library check.

A prompt for an AI assistant

This prompt drafts the tags as a CSV that you review before you apply anything. Paste it into an AI assistant with your file names. More prompts are in Set up commercial breaks.

From the file names below, make a CSV for me to review. Columns: file, kind, category, holiday, year, rating.
Rules:
- kind, category, and holiday are Plex genres.
- kind: Commercial, Promo, PSA, or Bumper.
- category: one genre, such as Toys & Games, Video Games, Kids Food, Food & Drink, Restaurants, Cars, Movies & Home Video, TV Promos, or Beer & Alcohol.
- holiday: blank, or "Holiday: <name>" with Christmas, Halloween, Thanksgiving, Valentine's, New Year, Easter, Independence Day, or St. Patrick's Day.
- year: the year the spot first aired.
- rating: a Plex content rating. Kids channels take only TV-Y, TV-Y7, TV-G, or G. TV-MA, R, NC-17, and X play only on After Dark channels.
- Leave a field blank when you are not sure. Do not guess.
- Do not download or source ads. I supply files I have the right to use.
- Ask me before any change to my files or to Plex.

<paste the file names here>

If it does not work

  • Holiday spots play out of season. They are on their own holiday channel, which plays them whenever it is on.
  • A kids spot never plays on kids channels. Check that its rating is TV-Y, TV-Y7, TV-G, or G.
  • A category does nothing. Only the categories above drive rules. Others are still labels.

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

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

Menu

Join the beta