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

100 lines
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](https://metamanager.wiki/en/nightly/config/libraries.html#overlay-path) 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) |