List of Defaults Files¶

The below table outlines the available Defaults files which can be called via metadata_path (for Collections), overlay_path (for Overlays) and playlist_files (for Playlists).

Collections¶

These files can generally be used on both Movie and Show library-types, or are part of a category of collection (such as Award Shows.)

These collections are applied by calling the below paths into the metadata_path section of your config.yml

Award Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Award Separator	`separator_award`	Award Collections	✅	✅
Academy Awards (Oscars)	`oscars`	Best Picture Winners	✅	❌
British Academy of Film Awards	`bafta`	BAFTA Best Films, BAFTA 2021	✅¹	❌
Cannes Film Festival Awards	`cannes`	Cannes - Palme d’or, Cannes 2018	✅¹	❌
Critics Choice Awards	`choice`	Critics Choice Awards 2020	✅¹	✅¹
Emmy Awards	`emmy`	Emmys 2021	✅	✅
Golden Globe Awards	`golden`	Best Motion Pictures	✅	✅
Independent Spirit Awards	`spirit`	Independent Spirit Awards 2021	✅¹	❌
Sundance Film Festival Awards	`sundance`	Sundance Grand Jury Winners	✅¹	❌
Other Awards	`other_award`	Berlinale Golden Bears, Venice Golden Lions	✅¹	❌

¹ Requires Trakt Authentication

Chart Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Chart Separator	`separator_chart`	Chart Collections	✅	✅
Basic Charts	`basic`	Newly Released, New Episodes	✅	✅
Tautulli Charts	`tautulli`	Plex Popular, Plex Watched	✅²	✅²
IMDb Charts	`imdb`	IMDb Popular, IMDb Top 250	✅	✅
TMDb Charts	`tmdb`	TMDb Popular, TMDb Airing Today	✅	✅
Trakt Charts	`trakt`	Trakt Popular, Trakt Trending	✅¹	✅¹
AniList Charts	`anilist`	AniList Popular, AniList Season	✅	✅
MyAnimeList Charts	`myanimelist`	MyAnimeList Popular, MyAnimeList Top Rated	✅	✅
Other Charts	`other_chart`	AniDB Popular, Common Sense Selection	✅	✅

¹ Requires Trakt Authentication ² Requires Tautulli Authentication

Content Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Genres	`genre`	Action, Drama, Science Fiction	✅	✅
Franchises Movie/Show	`franchise`	Star Wars: Skywalker Saga, Godzilla (Anime)	✅	✅
Universes	`universe`	Marvel Cinematic Universal, Wizarding World	✅	✅
Based On…	`based`	Based on a Book, Based on a True Story	✅	✅

Content Rating Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
US Content Ratings Movie/Show	`content_rating_us`	G, PG, NC-17	✅	✅
UK Content Ratings	`content_rating_uk`	U, PG, 12A	✅	✅
MyAnimeList Content Ratings	`content_rating_mal`	G, PG, PG-13, R, R+, Rx	✅	✅
Common Sense Media Content Ratings	`content_rating_cs`	1, 2, 3, 4, 5, 6, 15, 16, 17, 18	✅	✅

Location Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Countries Movie/Show	`country`	Belgium, India	✅	✅
Regions Movie/Show	`region`	Iberia, Balkans	✅	✅
Continents Movie/Show	`continent`	Asia, North America	✅	✅

Media Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Aspect Ratios	`aspect`	1.33, 1.65, 1.78, 1.85, 2.77	✅	✅
Resolutions	`resolution`	4K Movies, 1080p Movies, 720p Movies	✅	✅
Audio Languages	`audio_language`	French Audio, Korean Audio	✅	✅
Subtitle Languages	`subtitle_language`	German Subtitles, Swedish Subtitles	✅	✅

Production Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Networks	`network`	Disney Channel, Lifetime	❌	✅
Streaming	`streaming`	Disney+ Movies, Max Shows	✅	✅
Studios	`studio`	DreamWorks Studios, Walt Disney Pictures	✅	✅

People Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Actors	`actor`	Chris Hemsworth, Margot Robbie	✅	✅
Directors	`director`	Steven Spielberg (Director), Olivia Wilde (Director)	✅	❌
Producers	`producer`	James Cameron (Producer), Reese Witherspoon (Producer)	✅	❌
Writers	`writer`	James Cameron (Writer), Lilly Wachowski (Writer)	✅	❌

Time Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Seasonal	`seasonal`	Easter, Christmas	✅	❌
Years	`year`	Best of 2010, Best of 2019	✅	✅
Decades Movie/Show	`decade`	Best of 2012, Best of 2022	✅	✅

Utility Collections¶

Default	Path	Example Collections	Works with Movies	Works with Shows
Collectionless	`collectionless`	Collectionless	✅	✅

Overlays¶

These files apply overlays and can generally be used on both Movie and Show library-types, and often works at the season and episode-level too.

It should be noted that when an overlay has ❗ for a season or episode, it normally means that whilst the overlay can technically be applied at the level, it wasn’t designed for this purpose. For example, a show’s season cannot have a resolution since it is not a video file, and an episode cannot have a commonsense age-rating since only Movies and Shows are rated by CommonSense.

In the scenario where there is missing data such as age ratings for episodes, then generally the highest-level data available will be applied at the lower level (i.e. a Show’s CommonSense age rating would apply to all episodes).

These overlays are applied by calling the below paths into the overlay_path section of your config.yml

Chart Overlays¶

Default	Path	Example Overlays	Movies	Shows	Seasons	Episodes
Ribbon	`ribbon`	IMDb Top 250 Ribbon, RT Fresh Ribbon	✅	✅	❌	❌

Content Overlays¶

Default	Path	Example Overlays	Movies	Shows	Seasons	Episodes
Episode Info	`episode_info`	“S01E01”, “S02E09”	❌	❌	❌	✅
Mediastinger	`mediastinger`	Mediastinger Logo for After/During Credit Scenes	✅	✅	❌	❌
Ratings¹	`ratings`	IMDb Audience Rating, Metacritic Critic Rating	✅	✅	❌	✅
Status	`status`	Airing, Returning, Canceled, Ended	❌	✅	❌	❌

¹ Requires Template Variables to function

Media Overlays¶

Default	Path	Example Overlays	Movies	Shows	Seasons	Episodes
Aspect Ratio¹	`aspect`	“1.33”,”1.78”	✅	✅	✅	✅
Audio Codec¹	`audio_codec`	Dolby Atmos logo, DTS logo	✅	✅	✅	✅
Audio/Subtitle Language Count	`language_count`	Dual-Audio, Multi-Audio, Dual-Subtitle, Multi-Subtitle	✅	✅	✅	✅
Audio/Subtitle Language Flags	`languages`	Flags Based on the Audio/Subtitles a file has	✅	✅	✅	✅
Resolution/Editions²	`resolution`	4K Dolby Vision logo, 720P logo, “Director’s Cut”, “Criterion Collection”	✅	✅	❌	✅
Runtimes	`runtimes`	“Runtime: 1h 30m”	✅	✅	❌	✅
Versions	`versions`	Multiple Versions logo	✅	✅	✅	✅
Video Format¹	`video_format`	“REMUX”, “HDTV”	✅	❗	❗	✅

¹ Designed for TRaSH Guides filename naming scheme ² Requires Plex Pass or TRaSH Guides filename naming scheme

Production Overlays¶

Default	Path	Example Overlays	Movies	Shows	Seasons	Episodes
Network	`network`	“ABC”, “CBS”	❌	✅	✅	✅
Streaming	`streaming`	Netflix logo, Hulu logo	✅	✅	❌	❌
Studio	`studio`	“Warner Bros. Pictures”, “Amblin Entertainment”	✅	✅	✅	✅

Utility Overlays¶

Default	Path	Example Overlays	Movies	Shows	Seasons	Episodes
Direct Play	`direct_play`	“Direct Play Only”	✅	❗	❗	✅

Playlists¶

These files apply playlists to the “Playlists” section of Plex and are applied by calling the below paths into the playlist_files section of your config.yml

Playlist Files¶

Default	path	Example Overlays
Playlist	`playlist`	Arrowverse (Timeline Order), Pokémon (Timeline Order)