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:
| # | Channel | Rule in plain words |
|---|---|---|
| 2 | The Mix | Any movie or episode |
| 4 | Laugh Track | Comedy episodes, 35 minutes or less |
| 17 | Fresh Tape | Added in the last 60 days |
| 18 | Deep Cuts | Never watched |
| 27 | Family Matinee | Movies rated G or PG |
| 31 | Long Haul | Movies 150 minutes or longer |
| 42 | 80s Mix | Anything from 1980 to 1989 |
| 147 | British Movies | Movies from the United Kingdom |
The fields a rule can read:
| Plex field | Used by | Notes |
|---|---|---|
| Genres | Most channels | Compared without regard to case |
| Year | Decades, Movie Club, decade sitcom, drama, and cartoon channels | Release year |
| Content rating | Kids, After Dark, family channels, Kids mode | TV-Y to TV-MA, G to NC-17 |
| Kind | Episode channels and movie channels | Movie or episode |
| Runtime | Laugh Track, Half Hour, The Hour, Long Haul, and more | In minutes |
| Date added | Fresh Tape | Last 60 days |
| View count | Deep Cuts | Never watched |
| Country | British Movies | United Kingdom or UK |
| Studio | Network channels | Generated |
| Collection | Collection and film series channels, holiday channels | Generated and seasonal |
| Cast and director | Actor and director channels | Generated |
| Labels | Holiday channels | Christmas, Halloween, and others |
| Title and summary words | Holiday channels | Whole words only |
| Air date | Holiday channels | Month 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:
| Kind | Numbers | Appears when | Most channels |
|---|---|---|---|
| Actors | 300 to 399 | 6 or more items | 20 |
| Directors | 400 to 499 | 5 or more items | 20 |
| Networks and studios | 500 to 549 | 20 or more hours | 50 |
| Plex collections | 550 to 599 | 8 or more items | 50 |
| Film series | 600 to 699 | A collection of 3 or more movies, all movies | 100 |
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.
- Your Plex library
- Filters: movies under 40 minutes, commercials and trailers, duplicates
- Channel rules
- The threshold
- 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
- Sort your TV shows by genre in Plex and look for shows with none. Add at least one.
- Check that comedy series carry Comedy, dramas carry Drama, and cartoons carry Animation. These three feed dozens of channels.
- 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.
- Use the same spelling every time. Case does not matter, but the spelling must match.
Years
- 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.
- Spot-check old films that Plex matched to a remake. A wrong year sends a film to the wrong decade.
Content ratings
- 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.
- Rate kids shows TV-Y, TV-Y7, or TV-G and kids films G. See kids channels from your library.
- 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
- 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
- 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.
- 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.
- Make a "Christmas" collection and a "Halloween" collection. The holiday movie channels read collection names. See holiday marathons.
Labels and dates
- Add a Christmas or Halloween label to holiday films that do not say so in the title.
- Check air dates on holiday episodes. Some holiday channels read an episode's original air date.
Kind and runtime
- Keep movies in movie libraries and series in TV libraries. Episode channels count episodes; movie channels count movies.
- 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
- https://support.plex.tv/articles/201272763-edit-details/ Read 2026-11-14
- 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
CHANNELS
Up to 140 TV channels from your Plex library
SpiteTV sorts your Plex movies and shows onto up to 140 virtual TV channels in 11 packages, plus channels for your actors, directors, studios, and film series.
CHANNELS
Channel lineup
SpiteTV sorts your Plex library into up to 140 numbered channels on Apple TV. A channel airs when you own enough to fill it. Every one of them is free.
CH 300 to 699 · YOUR LIBRARY
Generated channels for actors, directors, and film series
SpiteTV counts your Plex library and builds channels 300 to 699 for actors, directors, studios, collections, and film series. No setup, and none cost extra.
Channels
How a channel qualifies
Why a SpiteTV channel appears or not: channel rules, the 6-hour and 4-movie minimums, items no channel takes, and the package, season, and kids checks.
Guide
How a TV schedule works
Why you join a show in the middle, why two TVs agree with no server, true start times against quarter-hour starts, what fills the gap, and when shows repeat.
Guide
Set up kids channels with a PIN
Set up kids channels from your own Plex library on Apple TV: how Kids mode and its PIN work, which channels suit children, and how to prepare the library.
Lineup ideas
Holiday marathons that start themselves
The 15 SpiteTV seasonal channels, the dates they switch on, how they find holiday episodes in your Plex library, and how to fill them for a holiday marathon.
SpiteTV for Apple TV is in beta. Join the beta.
