You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Plex-Meta-Manager/docs/defaults/files.md

10 KiB

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

Chart Collections

Source config.yml entry Example Collections Created Works with Movies Works with Shows
AniList anilist AniList Popular, AniList Season
Basic basic Newly Released, New Episodes
IMDb imdb IMDb Popular, IMDb Top 250
MyAnimeList myanimelist MyAnimeList Popular, MyAnimeList Top Rated
Other other AniDB Popular, Common Sense Selection
Tautulli tautulli Plex Popular, Plex Watched
TMDb tmdb TMDb Popular, TMDb Airing Today
Trakt trakt Trakt Popular, Trakt Trending

Award Collections

Award Show config.yml entry Example Collections Created Works with Movies Works with Shows
BAFTA bafta BAFTA Best Films, BAFTA 2021
Cannes cannes Cannes - Palme d'or, Cannes 2018
Critics Choice choice Critics Choice Awards 2020
Emmys emmy Emmys 2021
Golden Globes golden Best Motion Pictures
Oscars oscars Best Picture Winners
Spirit spirit Independent Spirit Awards 2021
Sundance sundance Sundance Grand Jury Winners

General Collections

Theme config.yml entry Example Collections Created Works with Movies Works with Shows
Actor actor Chris Hemsworth, Margot Robbie
Audio Language audio_language French Audio, Korean Audio
Content Rating (UK) content_rating_uk U, PG, 12A
Content Rating (US) content_rating_us G, PG, NC-17
Country country Belgium, India
Decade decade Best of 2012, Best of 2022
Director director Steven Spielberg (Director), Olivia Wilde (Director)
Franchise franchise Star Wars: Skywalker Saga, Godzilla (Anime)
Genre genre Action, Drama, Science Fiction
Network network Disney Channel, Lifetime
Producer producer James Cameron (Producer), Reese Witherspoon (Producer)
Resolution resolution OR resolution_standards 4K, 1080 OR Ultra HD, Full HD
Seasonal seasonal Easter, Christmas
Streaming streaming Disney+ Movies, HBO Max Shows
Studio studio DreamWorks Studios, Walt Disney Pictures
Subtitle Language subtitle_language German Subtitles, Swedish Subtitles
Universe universe Marvel Cinematic Universal, Wizarding World
Year year Best of 2010, Best of 2019
Writer writer James Cameron (Writer), Lilly Wachowski (Writer)

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

Overlay Files

Theme path Example Overlays Movies Shows Seasons Episodes
Audio Codec audio_codec Dolby Atmos logo, DTS logo
Audio Language audio_language French Audio, Korean Audio
CommonSense Age Rating commonsense "3+", "16+"
Direct Play direct_play "Direct Play Only"
Editions editions Director's Cut logo, IMAX logo
Episode Info episode_info "S01E01", "S02E09"
Mediastinger mediastinger Mediastinger logo
Ratings ratings IMDb Audience Rating, Metacritic Critic Rating
Resolution resolution 4K Dolby Vision logo, 720P logo
Ribbon ribbon IMDb Top 250 Ribbon, RT Fresh Ribbon
Runtimes runtimes "Runtime: 1h 30m"
Special Releases special_release "Director's Cut", "Criterion Collection"
Streaming streaming Netflix logo, Hulu logo
Versions versions Multiple Versions logo
Video Format video_format "REMUX", "HDTV"

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

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