Skip to content

List of Defaults Files

The below table outlines the available Defaults Files which can be called via collection_files (for Collections), overlay_files (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 collection_files section of your config.yml

Default Path Example Collections Allowed Media
Award Separator separator_award Award Collections Movies
Shows
Academy Awards (Oscars) oscars Oscars Best Picture Winners, Oscars Best Director Winners, Oscars 2022 Movies
Berlin International Film Festival Awards berlinale Berlinale Golden Bears, Berlinale 2021 Movies
British Academy of Film Awards bafta BAFTA Best Films, BAFTA 2021 Movies
Cannes Film Festival Awards cannes Cannes Golden Palm Winners, Cannes 2018 Movies
César Awards cesar César Best Film Winners, César 2018 Movies
Critics Choice Awards choice Critics Choice Best Picture Winners, Critics Choice Awards 2020 Movies
Shows
Emmy Awards emmy Emmys Best in Category Winners, Emmys 2021 Movies
Shows
Golden Globe Awards golden Golden Globes Best Picture Winners, Golden Globes Best Director Winners, Golden Globe 2019 Movies
Shows
Independent Spirit Awards spirit Spirit Best Feature Winners, Independent Spirit Awards 2021 Movies
National Film Registry nfr National Film Registry All Time, National Film Registry 2021 Movies
People's Choice Awards pca People's Choice Award Winners, People's Choice Awards 2022 Movies
Shows
Razzie Awards razzie Razzies Golden Raspberry Winners, Razzie 2023 Movies
Screen Actors Guild Awards sag Screen Actors Guild Award Winners, Screen Actors Guild 2021 Movies
Shows
Sundance Film Festival Awards sundance Sundance Grand Jury Winners, Sundance Film Festival 2017 Movies
Toronto International Film Festival Awards tiff Toronto People's Choice Award, Toronto International Film Festival 2020 Movies
Venice Film Festival Awards venice Venice Golden Lions, Venice 2023 Movies
Default Path Example Collections Allowed Media
Chart Separator separator_chart Chart Collections Movies
Shows
Basic Charts basic Newly Released, New Episodes Movies
Shows
AniList Charts anilist AniList Popular, AniList Season Movies
Shows
IMDb Charts imdb IMDb Popular, IMDb Top 250 Movies
Shows
Letterboxd Charts letterboxd Letterboxd Top 250, Top 250 Most Fans Movies
MyAnimeList Charts myanimelist MyAnimeList Popular, MyAnimeList Top Rated Movies
Shows
Tautulli Charts(1) tautulli Plex Popular, Plex Watched Movies
Shows
TMDb Charts tmdb TMDb Popular, TMDb Airing Today Movies
Shows
Trakt Charts(2) trakt Trakt Popular, Trakt Trending Movies
Shows
Other Charts other_chart AniDB Popular, Common Sense Selection Movies
Shows
  1. Requires Tautulli Authentication
  2. Requires Trakt Authentication
Default Path Example Collections Allowed Media
Genres genre Action, Drama, Science Fiction Movies
Shows
Franchises Movie/Show franchise Star Wars: Skywalker Saga, Godzilla (Anime) Movies
Shows
Universes universe Marvel Cinematic Universal, Wizarding World Movies
Shows
Based On... based Based on a Book, Based on a True Story Movies
Shows
Collectionless collectionless Collectionless Movies
Shows
Default Path Example Collections Allowed Media
US Content Ratings Movie/Show content_rating_us G, PG, NC-17 Movies
Shows
UK Content Ratings content_rating_uk U, PG, 12A Movies
Shows
DE Content Ratings content_rating_de Films 12, Films 16, Films 18 Movies
Shows
AU Content Ratings content_rating_au G, PG, M, MA15+, R18+, X18+, NR Movies
Shows
NZ Content Ratings content_rating_nz G, PG, M, R13, RP13, R15, R16, RP16, R18, RP18, R, NR Movies
Shows
MyAnimeList Content Ratings content_rating_mal G, PG, PG-13, R, R+, Rx Movies
Shows
Common Sense Media Content Ratings content_rating_cs 1, 2, 3, 4, 5, 6, 15, 16, 17, 18 Movies
Shows
Default Path Example Collections Allowed Media
Countries Movie/Show country Belgium, India Movies
Shows
Regions Movie/Show region Iberia, Balkans Movies
Shows
Continents Movie/Show continent Asia, North America Movies
Shows
Default Path Example Collections Allowed Media
Aspect Ratios aspect 1.33, 1.65, 1.78, 1.85, 2.77 Movies
Shows
Resolutions resolution 4K Movies, 1080p Movies, 720p Movies Movies
Shows
Audio Languages audio_language French Audio, Korean Audio Movies
Shows
Subtitle Languages subtitle_language German Subtitles, Swedish Subtitles Movies
Shows
Default Path Example Collections Allowed Media
Actors actor Chris Hemsworth, Margot Robbie Movies
Shows
Directors director Steven Spielberg (Director), Olivia Wilde (Director) Movies
Producers producer James Cameron (Producer), Reese Witherspoon (Producer) Movies
Writers writer James Cameron (Writer), Lilly Wachowski (Writer) Movies
Default Path Example Collections Allowed Media
Networks network Disney Channel, Lifetime Shows
Streaming streaming Disney+ Movies, Max Shows Movies
Shows
Studios studio DreamWorks Studios, Walt Disney Pictures Movies
Shows
Default Path Example Collections Allowed Media
Seasonal seasonal Easter, Christmas Movies
Years year Best of 2010, Best of 2019 Movies
Shows
Decades Movie/Show decade Best of 2012s, Best of 2022s Movies
Shows

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.

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 Common Sense age rating would apply to all episodes).

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

Default Path Example Overlays Allowed Media
Ribbon ribbon IMDb Top 250 Ribbon, RT Fresh Ribbon Movies
Shows
Default Path Example Overlays Allowed Media
Episode Info episode_info "S01E01", "S02E09" Episodes
Mediastinger mediastinger Mediastinger Logo for After/During Credit Scenes Movies
Shows
Ratings(1) ratings IMDb Audience Rating, Metacritic Critic Rating Movies
Shows
Episodes
Status status Airing, Returning, Canceled, Ended Shows
  1. Requires Template Variables to function
Default Path Example Overlays Allowed Media
US Content Ratings (Movie) content_rating_us_movie G, PG, PG-13, R, NC-17, NR Movies
US Content Ratings (Show) content_rating_us_show TV-G, TV-Y, TV-PG, TV-14, TV-MA, NR Shows
Seasons
Episodes
UK Content Ratings content_rating_uk U, PG, 12, 12a, 15, 18, R18, NR Movies
Shows
Seasons
Episodes
DE Content Ratings content_rating_de 0, 6, 12, 16, 18, BPjM, NR Movies
Shows
Seasons
Episodes
AU Content Ratings content_rating_au G, PG, M, MA15+, R18+, X18+, NR Movies
Shows
Seasons
Episodes
NZ Content Ratings content_rating_nz G, PG, M, R13, RP13, R15, R16, RP16, R18, RP18, R, NR Movies
Shows
Seasons
Episodes
Common Sense Age Rating commonsense 1+, 2+, 3+, 4+, ..., 17+, 18+, NR Movies
Shows
Seasons
Episodes
Default Path Example Overlays Allowed Media
Aspect Ratio(1) aspect "1.33","1.78" Movies
Shows
Seasons
Episodes
Audio Codec(2) audio_codec Dolby Atmos logo, DTS logo Movies
Shows
Seasons
Episodes
Audio/Subtitle Language Count language_count Dual-Audio, Multi-Audio, Dual-Subtitle, Multi-Subtitle Movies
Shows
Seasons
Episodes
Audio/Subtitle Language Flags languages Flags Based on the Audio/Subtitles a file has Movies
Shows
Seasons
Episodes
Resolution/Editions(3) resolution 4K Dolby Vision logo, 720P logo, "Director's Cut", "Criterion Collection" Movies
Shows
Episodes
Runtimes runtimes "Runtime: 1h 30m" Movies
Shows
Episodes
Versions versions Multiple Versions logo Movies
Shows
Seasons
Episodes
Video Format(4) video_format "REMUX", "HDTV" Movies
Shows(5)
Seasons(6)
Episodes
  1. Designed to use the TRaSH Guides filename naming scheme
  2. Designed to use the TRaSH Guides filename naming scheme
  3. Editions overlay is designed to use the Editions field within Plex [which requires Plex Pass to use] or the TRaSH Guides filename naming scheme
  4. Designed to use the TRaSH Guides filename naming scheme
  5. While these overlays can technically be applied at this level, they were not designed for it. For example, a show's season cannot have a resolution since it is not a video file, and an episode cannot have a Common Sense rating since only Movies and Shows are rated by Common Sense.
  6. While these overlays can technically be applied at this level, they were not designed for it. For example, a show's season cannot have a resolution since it is not a video file, and an episode cannot have a Common Sense rating since only Movies and Shows are rated by Common Sense.
Default Path Example Overlays Allowed Media
Network network "ABC", "CBS" Shows
Seasons
Episodes
Streaming streaming Netflix logo, Hulu logo Movies
Shows
Studio studio "Warner Bros. Pictures", "Amblin Entertainment" Movies
Shows
Seasons
Episodes
Default Path Example Overlays Allowed Media
Direct Play direct_play "Direct Play Only" Movies
Shows(1)
Seasons(2)
Episodes
  1. While these overlays can technically be applied at this level, they were not designed for it. For example, a show's season cannot have a resolution since it is not a video file, and an episode cannot have a Common Sense rating since only Movies and Shows are rated by Common Sense.
  2. While these overlays can technically be applied at this level, they were not designed for it. For example, a show's season cannot have a resolution since it is not a video file, and an episode cannot have a Common Sense rating since only Movies

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

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