Collection Defaults¶
There are many Default Metadata Files built into PMM itself which offer an easy-to-use and customizable set of Collections that the user can achieve without having to worry about creating the files that makes the collections possible.
This is the simplest way to create Collections using Plex Meta Manager.
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¶
Default |
Path |
Example Collections |
Works with Movies |
Works with Shows |
|---|---|---|---|---|
|
Chart Collections |
✅ |
✅ |
|
|
AniList Popular, AniList Season |
✅ |
✅ |
|
|
Newly Released, New Episodes |
✅ |
✅ |
|
|
Top Disney, Top Hbo, Top Hulu, Top Netflix |
✅ |
✅ |
|
|
IMDb Popular, IMDb Top 250 |
✅ |
✅ |
|
|
MyAnimeList Popular, MyAnimeList Top Rated |
✅ |
✅ |
|
|
AniDB Popular, Common Sense Selection |
✅ |
✅ |
|
|
Plex Popular, Plex Watched |
✅ |
✅ |
|
|
TMDb Popular, TMDb Airing Today |
✅ |
✅ |
|
|
Trakt Popular, Trakt Trending |
✅ |
✅ |
Award Collections¶
Default |
Path |
Example Collections |
Works with Movies |
Works with Shows |
|---|---|---|---|---|
|
Award Collections |
✅ |
✅ |
|
|
BAFTA Best Films, BAFTA 2021 |
✅ |
❌ |
|
|
Cannes - Palme d’or, Cannes 2018 |
✅ |
❌ |
|
|
Critics Choice Awards 2020 |
✅ |
✅ |
|
|
Emmys 2021 |
✅ |
✅ |
|
|
Best Motion Pictures |
✅ |
✅ |
|
|
Best Picture Winners |
✅ |
✅ |
|
|
Independent Spirit Awards 2021 |
✅ |
❌ |
|
|
Sundance Grand Jury Winners |
✅ |
✅ |
|
|
Berlinale Golden Bears, Venice Golden Lions |
✅ |
❌ |
General Collections¶
Default |
Path |
Example Collections |
Works with Movies |
Works with Shows |
|---|---|---|---|---|
|
Chris Hemsworth, Margot Robbie |
✅ |
✅ |
|
|
French Audio, Korean Audio |
✅ |
✅ |
|
|
Collectionless |
✅ |
✅ |
|
|
1, 2, 3, 4, 5, 6, 15, 16, 17, 18 |
✅ |
✅ |
|
|
G, PG, PG-13, R, R+, Rx |
✅ |
✅ |
|
|
U, PG, 12A |
✅ |
✅ |
|
|
G, PG, NC-17 |
✅ |
✅ |
|
|
Belgium, India |
✅ |
✅ |
|
|
Best of 2012, Best of 2022 |
✅ |
✅ |
|
|
Steven Spielberg (Director), Olivia Wilde (Director) |
✅ |
❌ |
|
|
Star Wars: Skywalker Saga, Godzilla (Anime) |
✅ |
✅ |
|
|
Action, Drama, Science Fiction |
✅ |
✅ |
|
|
Disney Channel, Lifetime |
❌ |
✅ |
|
|
James Cameron (Producer), Reese Witherspoon (Producer) |
✅ |
❌ |
|
|
4K Movies, 1080p Movies, 720p Movies |
✅ |
✅ |
|
|
Easter, Christmas |
✅ |
❌ |
|
|
Disney+ Movies, HBO Max Shows |
✅ |
✅ |
|
|
DreamWorks Studios, Walt Disney Pictures |
✅ |
✅ |
|
|
Bones, Studio Ghibli, Toei Animation |
✅ |
✅ |
|
|
German Subtitles, Swedish Subtitles |
✅ |
✅ |
|
|
Marvel Cinematic Universal, Wizarding World |
✅ |
❌ |
|
|
Best of 2010, Best of 2019 |
✅ |
✅ |
|
|
James Cameron (Writer), Lilly Wachowski (Writer) |
✅ |
❌ |
Configurations¶
To run a default pmm Metadata file you can simply add it to your metadata_path using pmm like so:
libraries:
Movies:
metadata_path:
- pmm: actor
- pmm: genre
Separators¶
Most Metadata files use separators to denote different sections of collection like actor collections vs studio collections.
Chart Separator and Award Separator each have their own file, while the other Separators are part of their respective files.
Click to expand to see an example of Separators.
Library On/Off¶
Chart Separators are turned On by default (except seasonal), to turn the Separators On/Off on a per Library basis.
libraries:
LIBRARYNAME:
template_variables:
use_separator: false
metadata_path:
- pmm: actor
- pmm: genre
Collection Section Order¶
All Default Metadata Files have a collection_section attribute. These attributes determine the order of the various sections and can be set by customizing your config.
For example: collection_section: 01 translates to sort_title: "!<<collection_section>><<pre>><<order_<<key>>>><<sort>>" and so for genre if you have a Fantasy collection, plex is going to show !06_Fantasy
This is the default PMM collection ordering:
Collection |
Collection Section |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Customizing Configs¶
Configs can be customized using the template_variables attribute when calling the file. These template_variables will be given to every template call in the file which allows them to affect how that file runs.
This example changes the ratings overlay to work on episodes.
libraries:
TV Shows:
metadata_path:
- pmm: imdb
template_variables:
use_popular: false
use_lowest: false
visible_library_top: true
visible_home_top: true
visible_shared_top: true
Each file has a page on the wiki showing the available template_variables for each file. For example the default pmm: genre has a page here.
In addition to the defined template_variables almost all default Metadata files have access to the Shared Variables.
Examples¶
For example if you want yearly oscar collections that go back 10 years instead of 5 all of which gets sent to radarr use the data and radarr_add_missing template variables.
libraries:
Movies:
metadata_path:
- pmm: oscars
template_variables:
radarr_add_missing: true
data:
starting: current_year-10
ending: current_year
Or maybe you want to change the number of actor collections made using pmm: actor.
libraries:
Movies:
overlay_path:
- pmm: actor
template_variables:
collection_mode: hide
data:
depth: 5
limit: 50
Or maybe you want to change the collection sort order of the genre collections using pmm: genre.
libraries:
Movies:
metadata_path:
- pmm: genre
template_variables:
collection_section: 11
Or maybe you want to disable separators globally per library.
libraries:
LIBRARYNAME:
template_variables:
use_separator: false
metadata_path:
- ...
Alternatively it can be turned off individually per git file:
libraries:
LIBRARYNAME:
metadata_path:
- pmm: <file1> # separator is disabled
template_variables:
use_separator: false
- pmm: <file2> # separator is enabled by default
- pmm: <file3> # separator is disabled
template_variables:
use_separator: false
Example Configuration File¶
Click to expand sample config.yml file:
libraries:
Movies: # Must match a library name in your Plex
report_path: config/missing/Movies_missing.yml
template_variables:
sep_style: gray # use the gray separators globally for this library
collection_mode: hide # hide the collections
language: fr # could be default, de, fr, pt-br or another lang code that we have tranlsated
placeholder_imdb_id: tt8579674 # 1917 (2019) placeholder id for the separators
metadata_path:
- pmm: separator_award # An "index card"
- pmm: bafta # BAFTA Awards
template_variables: # based on when the award show started
data:
starting: 2014
ending: current_year
- pmm: cannes # Cannes Film Festival Awards
template_variables: # based on when the award show started
data:
starting: 2016
ending: current_year
- pmm: choice # Critic's Choice Awards
template_variables: # based on when the award show started
data:
starting: 2014
ending: current_year
- pmm: golden # Golden Globes Awards
template_variables: # based on when the award show started
data:
starting: 1943
ending: current_year
- pmm: oscars # The Oscars
template_variables: # based on when the award show started
data:
starting: 1927
ending: current_year
- pmm: other_award # Other award collections
- pmm: spirit # Independent Spirit Awards
template_variables: # based on when the award show started
data:
starting: 2014
ending: current_year
- pmm: sundance # Sundance Film Festival Awards
template_variables: # based on when the award show started
data:
starting: 2010
ending: current_year
- pmm: separator_chart # An "index card"
- pmm: anilist # AniDB Charts (Popular, Trending, etc.)
- pmm: imdb # IMDb Charts (Popular, Trending, etc.)
- pmm: myanimelist # MAL Charts (Popular, Trending, etc.)
- pmm: other_chart # Other Charts (Popular, Trending, etc.)
- pmm: tautulli # Tautulli Charts (Popular, Trending, etc.)
- pmm: tmdb # TMDb Charts (Popular, Trending, etc.)
- pmm: trakt # Trakt Charts (Popular, Trending, etc.)
- pmm: flixpatrol # Flixpatrol Charts (Popular, Trending, etc.)
- pmm: basic # Some basic chart collections
- pmm: collectionless # Collectionless movies/shows
- pmm: actor # Actors
template_variables: # bw, rainier, or orig style is used. depth and limit is set low but sometimes I boost to 10, 150
style: bw
data:
depth: 1
limit: 15
- pmm: director # Directors
template_variables: # bw, rainier, or orig style is used. depth and limit is set low but sometimes I boost to 10, 150
style: bw
data:
depth: 1
limit: 15
- pmm: producer # Producers
template_variables: # bw, rainier, or orig style is used. depth and limit is set low but sometimes I boost to 10, 150
exclude: # ever have some random person... you can exclude them if you want
- Jeremy Kleiner
- Thomas Hayslip
style: bw
data:
depth: 1
limit: 15
- pmm: writer # Writers
template_variables: # bw, rainier, or orig style is used. depth and limit is set low but sometimes I boost to 10, 150
style: bw
data:
depth: 1
limit: 15
- pmm: audio_language # English, French, Arabic, German, etc. audio language
- pmm: content_rating_cs # Choose content_rating_uk, content_rating_us, or content_rating_cs
- pmm: genre # Action, Comedy, Drama, etc.
- pmm: resolution # 4K HDR, 1080P FHD, etc. with the standards style
template_variables:
style: standards
- pmm: studio # DreamWorks Studios, Lucasfilm Ltd, etc.
- pmm: studio_anime # Anime Studios etc.
- pmm: subtitle_language # English, French, Arabic, German, etc. subtitles
- pmm: year # Year the media item was released starting from 1880 to current_year
template_variables:
data:
starting: 1880
ending: current_year
- pmm: country # Country associated to the media item
- pmm: decade # Decade the media item was released
- pmm: seasonal # Christmas, Halloween, etc.
template_variables: # Canadian Thankgsgiving is a different date range. Otherwise, I want to ALWAYS see the seasonal
schedule_independence: daily
schedule_easter: daily
schedule_valentine: daily
schedule_patrick: daily
schedule_thanksgiving: range(10/01-10/31)
schedule_halloween: daily
schedule_christmas: daily
schedule_years: daily
schedule_mother: daily
schedule_memorial: daily
schedule_father: daily
schedule_labor: daily
- pmm: streaming # Streaming on Disney+, Netflix, etc.
- pmm: universe # Marvel Cinematic Universe, Wizarding World, etc.
overlay_path:
- remove_overlays: false # Set to true if you want to remove overlays
- reapply_overlay: false # If you are doing a lot of testing and changes like me, keep this to true to always reapply overlays
# - reset_overlays: tmdb # if you want to reset the poster to default poster from tmdb
- pmm: audio_codec # FLAC, DTS-X, TrueHD, etc. style: standard/compact. compact is default
- pmm: language_count # blank means 1 audio language track, dual means 2, multi means > 2
- pmm: commonsense # Age 2+, Age 14+, etc.
- pmm: flixpatrol # Top 10 flixpatrol for 'this_year', positioned on the left
template_variables:
position: left
time_window: this_year
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
use_subtitles: true
- pmm: mediastinger # Mediastinger overlay when the media item contains a stinger at the end of the movie/show or during the credits
- pmm: ratings # Ratings with custom fonts matched to the style of the rating, font_size, and on the right in 'square' format
template_variables:
rating1: user
rating1_image: rt_tomato
rating2: critic
rating2_image: imdb
rating3: audience
rating3_image: tmdb
horizontal_position: right
- pmm: resolution # 4K HDR, 1080P FHD, etc.
- pmm: ribbon # Used for ribbon in bottom right
- pmm: streaming # Streaming on Disney+, Netflix, etc.
- pmm: versions # Will show duplicates for that media item in top right area
- pmm: video_format # Remux, DVD, Blu-Ray, etc. in bottom left
settings:
asset_directory:
- config/assets
operations:
split_duplicates: false
assets_for_all: false
delete_unmanaged_collections: true # Any manually added collection outside of PMM will be deleted
mass_user_rating_update: mdb_tomatoes # Update user ratings with mdb_tomatoes
mass_critic_rating_update: imdb # Update critic ratings with imdb
mass_audience_rating_update: tmdb # Update audience ratings with tmdb
mass_genre_update: tmdb # Update all genres from tmdb
mass_content_rating_update: mdb_commonsense # Changes Content Rating to "1", "2" etc. to specify appropriate age
mass_originally_available_update: tmdb # Update all original available date from tmdb
mass_imdb_parental_labels: without_none
TV Shows: # Must match a library name in your Plex
report_path: config/missing/TV_missing.yml
template_variables:
sep_style: gray # use the gray separators globally for this library
collection_mode: hide # hide the collections
language: fr # could be default, de, fr, pt-br or another lang code that we have tranlsated
placeholder_imdb_id: tt1190634 # The Boys (2019) placeholder id for the separators
metadata_path:
- pmm: separator_award # An "index card"
- pmm: choice # Critic's Choice Awards
template_variables: # based on when the award show started
data:
starting: 2014
ending: current_year
- pmm: golden # Golden Globes Awards
template_variables: # based on when the award show started
data:
starting: 1943
ending: current_year
- pmm: emmy # Emmy Awards
template_variables: # based on when the award show started
data:
starting: 1947
ending: current_year
- pmm: separator_chart # An "index card"
- pmm: anilist # AniDB Charts (Popular, Trending, etc.)
- pmm: imdb # IMDb Charts (Popular, Trending, etc.)
- pmm: myanimelist # MAL Charts (Popular, Trending, etc.)
- pmm: other_chart # Other Charts (Popular, Trending, etc.)
- pmm: tautulli # Tautulli Charts (Popular, Trending, etc.)
- pmm: tmdb # TMDb Charts (Popular, Trending, etc.)
- pmm: trakt # Trakt Charts (Popular, Trending, etc.)
- pmm: flixpatrol # Flixpatrol Charts (Popular, Trending, etc.)
- pmm: basic # Some basic chart collections
- pmm: collectionless # Collectionless movies/shows
- pmm: actor # Actors
template_variables: # bw, rainier, or orig style is used. depth and limit is set low but sometimes I boost to 10, 150
exclude: # ever have some random person... you can exclude them if you want
- Macy Nyman
style: bw
data:
depth: 1
limit: 15
- pmm: audio_language # English, French, Arabic, German, etc. audio language
- pmm: content_rating_cs # Choose content_rating_uk, content_rating_us, or content_rating_cs
- pmm: genre # Action, Comedy, Drama, etc.
- pmm: resolution # 4K HDR, 1080P FHD, etc. with the standards style
template_variables:
style: standards
- pmm: studio # DreamWorks Studios, Lucasfilm Ltd, etc.
- pmm: studio_anime # Anime Studios etc.
- pmm: subtitle_language # English, French, Arabic, German, etc. subtitles
- pmm: year # Year the media item was released starting from 1880 to current_year
template_variables:
data:
starting: 1880
ending: current_year
- pmm: country # Country associated to the media item
- pmm: decade # Decade the media item was released
- pmm: network # ABC, CBC, NBC, FOX, etc.
- pmm: streaming # Streaming on Disney+, Netflix, etc.
overlay_path:
- remove_overlays: false # Set to true if you want to remove overlays
- reapply_overlay: false # If you are doing a lot of testing and changes like me, keep this to true to always reapply overlays
# - reset_overlays: tmdb # if you want to reset the poster to default poster from tmdb
- pmm: audio_codec # FLAC, DTS-X, TrueHD, etc. and works with overlay_level show, episode, and season
- pmm: audio_codec
template_variables:
overlay_level: episode
- pmm: audio_codec
template_variables:
overlay_level: season
- pmm: commonsense # Age 2+, Age 14+, etc. and works with overlay_level show, episode, and season
- pmm: commonsense
template_variables:
overlay_level: episode
- pmm: commonsense
template_variables:
overlay_level: season
- pmm: episode_info # SE##E## information in bottom right and works with overlay_level episode
template_variables:
overlay_level: episode
- pmm: flixpatrol # Top 10 flixpatrol for 'this_year', positioned on the left and works with overlay_level show
template_variables:
position: left
time_window: this_year
- pmm: language_count # blank means 1 audio language track, dual means 2, multi means > 2 and works with overlay_level show, episode, and season
- pmm: language_count
template_variables:
overlay_level: episode
- pmm: language_count
template_variables:
overlay_level: season
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
use_subtitles: true
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
overlay_level: episode
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
use_subtitles: true
overlay_level: episode
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
overlay_level: season
- pmm: languages # Languages spoken and subtitles with associated flags and two-digit lang codes
template_variables:
use_subtitles: true
overlay_level: season
- pmm: mediastinger # Mediastinger overlay when the media item contains a stinger at the end of the movie/show or during the credits and works with overlay_level show
- pmm: ratings # Ratings with custom fonts matched to the style of the rating, font_size, and on the right in 'square' format. overlay_level: show has 3 ratings max
template_variables:
rating1: user
rating1_image: rt_tomato
rating2: critic
rating2_image: imdb
rating3: audience
rating3_image: tmdb
horizontal_position: right
- pmm: ratings # Ratings with custom fonts matched to the style of the rating, font_size, and on the right in 'square' format. overlay_level: episode has 2 ratings max
template_variables:
rating1: critic
rating1_image: imdb
rating2: audience
rating2_image: tmdb
horizontal_position: right
overlay_level: episode
- pmm: resolution # 4K HDR, 1080P FHD, etc. and works with overlay_level show, episode, and season
- pmm: resolution
template_variables:
overlay_level: episode
- pmm: resolution
template_variables:
overlay_level: season
- pmm: ribbon # Used for ribbon in bottom right and works with overlay_level show and season
- pmm: ribbon
template_variables:
overlay_level: season
- pmm: runtimes # Runtime information in bottom right and works with overlay_level episode
template_variables:
overlay_level: episode
- pmm: status # Airing, Returning, Ended, Canceled and works with overlay_level show
- pmm: streaming # Streaming on Disney+, Netflix, etc. and works with overlay_level show, episode, and season
- pmm: streaming
template_variables:
overlay_level: episode
- pmm: streaming
template_variables:
overlay_level: season
- pmm: versions # Will show duplicates for that media item and works with overlay_level show, episode, and season
template_variables:
overlay_level: episode
- pmm: versions # Will show duplicates for that media item and works with overlay_level show, episode, and season
template_variables:
overlay_level: season
- pmm: versions # Will show duplicates for that media item and works with overlay_level show, episode, and season
template_variables:
overlay_level: show
- pmm: video_format # Remux, DVD, Blu-Ray, etc. in bottom left and works with overlay_level show, episode, and season
- pmm: video_format
template_variables:
overlay_level: episode
- pmm: video_format
template_variables:
overlay_level: season
settings:
asset_directory:
- config/assets
operations:
split_duplicates: false
assets_for_all: false
delete_unmanaged_collections: true # Any manually added collection outside of PMM will be deleted
mass_user_rating_update: mdb_tomatoes # Update user ratings with mdb_tomatoes
mass_critic_rating_update: imdb # Update critic ratings with imdb
mass_audience_rating_update: tmdb # Update audience ratings with tmdb
mass_genre_update: tmdb # Update all genres from tmdb
mass_content_rating_update: mdb_commonsense # Changes Content Rating to "1", "2" etc. to specify appropriate age
mass_originally_available_update: tmdb # Update all original available date from tmdb
mass_episode_critic_rating_update: imdb # Update critic ratings with imdb for episodes
mass_episode_audience_rating_update: tmdb # Update audience ratings with tmdb for episodes
mass_imdb_parental_labels: without_none
playlist_files:
- pmm: playlist
template_variables:
libraries: Movies, TV Shows