Plex-Meta-Manager/docs/defaults/files.md

102 lines
10 KiB
Markdown
Raw Normal View History

2022-09-27 15:08:18 +00:00
# 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
### 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) | ✅ | ❌ |
### Award Show Collections
| Award Show | config.yml entry | Example Collections Created | Works with Movies | Works with Shows |
|:---------------|:-----------------|----------------------------------|:-----------------:|:----------------:|
| BAFTA | `award/bafta` | BAFTA Best Films, BAFTA 2021 | ✅ | ❌ |
| Cannes | `award/cannes` | Cannes - Palme d'or, Cannes 2018 | ✅ | ❌ |
| Critics Choice | `award/choice` | Critics Choice Awards 2020 | ✅ | ✅ |
| Emmys | `award/emmy` | Emmys 2021 | ✅ | ✅ |
| Golden Globes | `award/golden` | Best Motion Pictures | ✅ | ✅ |
| Oscars | `award/oscars` | Best Picture Winners | ✅ | ✅ |
| Spirit | `award/spirit` | Independent Spirit Awards 2021 | ✅ | ❌ |
| Sundance | `award/sundance` | Sundance Grand Jury Winners | ✅ | ✅ |
### Chart Collections
| Source | config.yml entry | Example Collections Created | Works with Movies | Works with Shows |
|:------------|:--------------------|---------------------------------------------|:-----------------:|:----------------:|
| AniList | `chart/anilist` | AniList Popular, AniList Season | ✅ | ✅ |
| Basic | `chart/basic` | Newly Released, New Episodes | ✅ | ✅ |
| IMDb | `chart/imdb` | IMDb Popular, IMDb Top 250 | ✅ | ✅ |
| MyAnimeList | `chart/myanimelist` | MyAnimeList Popular, MyAnimeList Top Rated | ✅ | ✅ |
| Other | `chart/other` | AniDB Popular, Common Sense Selection | ✅ | ✅ |
| Tautulli | `chart/tautulli` | Plex Popular, Plex Watched | ✅ | ✅ |
| TMDb | `chart/tmdb` | TMDb Popular, TMDb Airing Today | ✅ | ✅ |
| Trakt | `chart/trakt` | Trakt Popular, Trakt Trending | ✅ | ✅ |
## 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 | `overlays/audio_codec` | Dolby Atmos logo, DTS logo | ✅ | ✅ | ✅ | ✅ |
| Audio Language | `overlays/audio_language` | French Audio, Korean Audio | ✅ | ✅ | ✅ | ✅ |
| CommonSense Age Rating | `overlays/commonsense` | "3+", "16+" | ✅ | ✅ | ❗ | ❗ |
| Direct Play | `overlays/direct_play` | "Direct Play Only" | ✅ | ❗ | ❗ | ✅ |
| Editions | `overlays/editions` | Director's Cut logo, IMAX logo | ✅ | ❌ | ❌ | ❌ |
| Episode Info | `overlays/episode_info` | "S01E01", "S02E09" | ❌ | ❌ | ❌ | ✅ |
| Mediastinger | `overlays/mediastinger` | Mediastinger logo | ✅ | ✅ | ❌ | ❌ |
| Ratings | `overlays/ratings` | IMDb Audience Rating, Metacritic Critic Rating | ✅ | ✅ | ❌ | ✅ |
| Resolution | `overlays/resolution` | 4K Dolby Vision logo, 720P logo | ✅ | ✅ | ❌ | ✅ |
| Ribbon | `overlays/ribbon` | IMDb Top 250 Ribbon, RT Fresh Ribbon | ✅ | ✅ | ❌ | ❌ |
| Runtimes | `overlays/runtimes` | "Runtime: 1h 30m" | ✅ | ✅ | ❌ | ❌ |
| Special Releases | `overlays/special_release` | "Director's Cut", "Criterion Collection" | ✅ | ✅ | ❗ | ❗ |
| Streaming | `overlays/streaming` | Netflix logo, Hulu logo | ✅ | ✅ | ❌ | ❌ |
| Versions | `overlays/versions` | Multiple Versions logo | ✅ | ✅ | ✅ | ✅ |
| Video Format | `overlays/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) |