for Apple TV

Tag your library for better channels

SpiteTV builds every channel from what Plex knows about your media. If Plex thinks your sitcom is a documentary, so does SpiteTV. Fix the metadata in Plex and the channels sort themselves out.

Published · Updated · By Ethercycle LLC

SpiteTV for Apple TV does not ask you to build channels. It reads what Plex knows about each movie and episode and sorts them into up to 140 channels, plus channels for actors, directors, studios, collections, and film series. So the channels you get depend on your metadata. Garbage in, garbage on channel 4. A comedy series with no Comedy genre is invisible to Laugh Track. A G-rated film with no rating never reaches Family Matinee.

How channel rules work

Every built-in channel is a rule. A rule combines conditions with "all of", "any of", and "none of". Some examples from the lineup:

#ChannelRule in plain words
2The MixAny movie or episode
4Laugh TrackComedy episodes, 35 minutes or less
17Fresh TapeAdded in the last 60 days
18Deep CutsNever watched
27Family MatineeMovies rated G or PG
31Long HaulMovies 150 minutes or longer
4280s MixAnything from 1980 to 1989
147British MoviesMovies from the United Kingdom

The fields a rule can read:

Plex fieldUsed byNotes
GenresMost channelsCompared without regard to case
YearDecades, Movie Club, decade sitcom, drama, and cartoon channelsRelease year
Content ratingKids, After Dark, family channels, Kids modeTV-Y to TV-MA, G to NC-17
KindEpisode channels and movie channelsMovie or episode
RuntimeLaugh Track, Half Hour, The Hour, Long Haul, and moreIn minutes
Date addedFresh TapeLast 60 days
View countDeep CutsNever watched
CountryBritish MoviesUnited Kingdom or UK
StudioNetwork channelsGenerated
CollectionCollection and film series channels, holiday channelsGenerated and seasonal
Cast and directorActor and director channelsGenerated
LabelsHoliday channelsChristmas, Halloween, and others
Title and summary wordsHoliday channelsWhole words only
Air dateHoliday channelsMonth and day, any year

The full list of channels and their rules is on the channel lineup.

The thresholds

A channel appears only when its rule matches enough. The defaults:

  • 6 hours of programs for most channels.
  • 4 movies for a channel where every match is a movie.
  • Seasonal channels set their own: 3 or 4 hours, or 3, 4, or 8 items.

A channel that sets both an hour count and an item count needs both. A channel below its minimum does not appear and keeps its number for later.

Generated channels have their own bars:

KindNumbersAppears whenMost channels
Actors300 to 3996 or more items20
Directors400 to 4995 or more items20
Networks and studios500 to 54920 or more hours50
Plex collections550 to 5998 or more items50
Film series600 to 699A collection of 3 or more movies, all movies100

Actors and directors are ranked by item count, so the 20 with the most items get channels. Studios are ranked by total hours. No generated channel takes a movie under 40 minutes.

  1. Your Plex library
  2. Filters: movies under 40 minutes, commercials and trailers, duplicates
  3. Channel rules
  4. The threshold
  5. Channels in the guide

What stays off every channel

Before any rule runs, SpiteTV clears out items that would make poor programs:

  • Items tagged Commercial, Promo, PSA, Bumper, or Trailer. These belong in a break library, not on channels.
  • Movies under 40 minutes, unless a channel's own rule sets a runtime range.
  • Anything shorter than 60 seconds or longer than 11 hours.
  • Duplicates. The same item in two libraries, or two copies of the same film or episode, play once.

Multi-part files count as one program with their parts added together.

Episodes inherit their show

Plex often keeps genres, the content rating, and labels on the show, not on each episode. An episode with no genres, rating, or labels of its own takes its show's.

So the fastest fix for a series that lands on the wrong channels is the show itself. Edit the show's genres and rating, and every episode without its own follows. If episodes do carry their own values, those win, so spot-check a few.

Fix metadata in Plex

Plex's help page explains editing. Tags such as "genres/categories, collections and more" are multi-value fields, and simple fields such as "Content Rating, Studio" are single entries. When you change a field by hand, Plex locks it: "Locked fields will not update on metadata refreshes." Your fix stays.

Plex says editing on a TV "is limited to artwork," so use Plex on the web or a phone for this.

Where Plex gets metadata depends on the library's agent. Plex's agent page says most agents pull data "from online resources," and lists the Personal Media agent for media "that won't appear in any online database." Home videos and other personal media usually arrive with little metadata, so they need the most hand-tagging.

The checklist

Work through this once. Budget an evening, more for a big library.

Genres

  1. Sort your TV shows by genre in Plex and look for shows with none. Add at least one.
  2. Check that comedy series carry Comedy, dramas carry Drama, and cartoons carry Animation. These three feed dozens of channels.
  3. Add the narrower genres that open up channels: Science Fiction, Fantasy, Horror, Thriller, Crime, Mystery, Western, War, History, Documentary, Reality, Game Show, Music, Musical, Sport, Home and Garden, Biography, Family, Anime, Romance, Adventure, Action.
  4. Use the same spelling every time. Case does not matter, but the spelling must match.

Years

  1. Check that every movie and show has a year. Missing years keep items off the decade channels: 70s Mix, 80s Mix, 90s Mix, and the decade sitcom, drama, cartoon, and movie channels.
  2. Spot-check old films that Plex matched to a remake. A wrong year sends a film to the wrong decade.

Content ratings

  1. Fill in missing ratings. Unrated items miss most channels that read ratings, and Kids mode hides them. A few holiday channels accept unrated items; see holiday marathons.
  2. Rate kids shows TV-Y, TV-Y7, or TV-G and kids films G. See kids channels from your library.
  3. Rate adult series TV-MA and adult films R where that is what they are. Late Shift, Late Drama, Rated R, and the rest of After Dark read those. See the late-night lineup.

Studios

  1. Check the studio field on your series. Network channels group by studio, 20 or more hours each. Two different names for the same network make two smaller groups, and neither may reach 20 hours.

Collections

  1. Build collections for things you want as a channel: a director's early work, a decade of one genre, a box set. Eight or more items earns a channel.
  2. Put each movie series in its own collection of movies only. Three or more films earn a film series channel that plays in release order. Each one has its own switch in Settings > Channels > Franchise Channels.
  3. Make a "Christmas" collection and a "Halloween" collection. The holiday movie channels read collection names. See holiday marathons.

Labels and dates

  1. Add a Christmas or Halloween label to holiday films that do not say so in the title.
  2. Check air dates on holiday episodes. Some holiday channels read an episode's original air date.

Kind and runtime

  1. Keep movies in movie libraries and series in TV libraries. Episode channels count episodes; movie channels count movies.
  2. Do not put shorts you want on channels in a movie library expecting them to play. Movies under 40 minutes stay off most channels. Put short episodes in a TV library instead, where Short Stuff (19) takes episodes of 15 minutes or less.

When changes reach the guide

SpiteTV shows its saved guide at launch, then checks your libraries in the background ("Checking your libraries"). It rereads only libraries Plex reports as changed. Then:

  • SpiteTV rebuilds only the channels whose list of programs changed. The rest keep their schedules.
  • A curated channel that newly meets its threshold appears with its fixed number. A new generated channel takes the lowest free number in its range.
  • A channel that falls below its threshold leaves the guide and keeps its number.
  • Recent additions join Fresh Tape at the next 6:00 AM.

A changed channel gets a new order from its new list, as how a TV schedule works explains.

Limits

  • SpiteTV reads metadata; it does not fetch any. If Plex does not know a show is a comedy, neither does SpiteTV.
  • There is no channel editor. Collections are the closest thing to a channel of your own.
  • Generated channels have caps: 20 actors, 20 directors, 50 studios, 50 collections, 100 film series.
  • One server at a time. Libraries on a second server are not read.

Sources

  1. https://support.plex.tv/articles/201272763-edit-details/ Read 2026-11-14
  2. https://support.plex.tv/articles/200241558-agents/ Read 2026-11-14

Asked and answered

Why do I have fewer channels than I expected?

Each channel needs enough matching programs: 6 hours by default, or 4 movies for a movie channel. Missing genres, ratings, or years are the usual cause. Check those fields in Plex first.

Do I have to tag every episode?

Usually only the show. An episode with no genre, content rating, or labels of its own takes its show's, so edit the show and its episodes follow.

How do I get a channel for a collection?

Make a Plex collection with 8 or more items. SpiteTV gives it a channel in the 550 to 599 range. A collection of 3 or more movies, with nothing else in it, also becomes a film series channel that plays in release order.

Why is a short film missing from every channel?

Movies under 40 minutes are left out of channels unless the channel's own rule sets a runtime range. Items under 60 seconds or over 11 hours are always left out.

When do my changes show up?

SpiteTV checks your libraries in the background at launch and rereads any library Plex reports as changed. A channel whose list changed is rebuilt; the rest keep their schedules.

Can I write my own channel rule?

No. SpiteTV has no channel editor. You shape channels by shaping the metadata they read, and by hiding channels or turning packages off.

Keep reading

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

Menu

Join the beta