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

Award Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Award Separator

separator_award

Award Collections

✅

✅

Academy Awards (Oscars)

oscars

Best Picture Winners

✅

❌

British Academy of Film Awards

bafta

BAFTA Best Films, BAFTA 2021

✅1

❌

Cannes Film Festival Awards

cannes

Cannes - Palme d’or, Cannes 2018

✅1

❌

Critics Choice Awards

choice

Critics Choice Awards 2020

✅1

✅1

Emmy Awards

emmy

Emmys 2021

✅

✅

Golden Globe Awards

golden

Best Motion Pictures

✅

✅

Independent Spirit Awards

spirit

Independent Spirit Awards 2021

✅1

❌

Sundance Film Festival Awards

sundance

Sundance Grand Jury Winners

✅1

❌

Other Awards

other_award

Berlinale Golden Bears, Venice Golden Lions

✅1

❌

1 Requires Trakt Authentication

Chart Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Chart Separator

separator_chart

Chart Collections

✅

✅

Basic Charts

basic

Newly Released, New Episodes

✅

✅

Tautulli Charts

tautulli

Plex Popular, Plex Watched

✅2

✅2

IMDb Charts

imdb

IMDb Popular, IMDb Top 250

✅

✅

TMDb Charts

tmdb

TMDb Popular, TMDb Airing Today

✅

✅

Trakt Charts

trakt

Trakt Popular, Trakt Trending

✅1

✅1

FlixPatrol Charts

flixpatrol

Top Disney, Top Max, Top Hulu, Top Netflix

✅

✅

AniList Charts

anilist

AniList Popular, AniList Season

✅

✅

MyAnimeList Charts

myanimelist

MyAnimeList Popular, MyAnimeList Top Rated

✅

✅

Other Charts

other_chart

AniDB Popular, Common Sense Selection

✅

✅

1 Requires Trakt Authentication 2 Requires Tautulli Authentication

Content Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Genres

genre

Action, Drama, Science Fiction

✅

✅

Franchises Movie/Show

franchise

Star Wars: Skywalker Saga, Godzilla (Anime)

✅

✅

Universes

universe

Marvel Cinematic Universal, Wizarding World

✅

✅

Based On…

based

Based on a Book, Based on a True Story

✅

✅

Content Rating Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

US Content Ratings Movie/Show

content_rating_us

G, PG, NC-17

✅

✅

UK Content Ratings

content_rating_uk

U, PG, 12A

✅

✅

MyAnimeList Content Ratings

content_rating_mal

G, PG, PG-13, R, R+, Rx

✅

✅

Common Sense Media Content Ratings

content_rating_cs

1, 2, 3, 4, 5, 6, 15, 16, 17, 18

✅

✅

Location Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Countries Movie/Show

country

Belgium, India

✅

✅

Regions Movie/Show

region

Iberia, Balkans

✅

✅

Continents Movie/Show

continent

Asia, North America

✅

✅

Media Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Aspect Ratios

aspect

1.33, 1.65, 1.78, 1.85, 2.77

✅

✅

Resolutions

resolution

4K Movies, 1080p Movies, 720p Movies

✅

✅

Audio Languages

audio_language

French Audio, Korean Audio

✅

✅

Subtitle Languages

subtitle_language

German Subtitles, Swedish Subtitles

✅

✅

Production Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Networks

network

Disney Channel, Lifetime

❌

✅

Streaming

streaming

Disney+ Movies, Max Shows

✅

✅

Studios

studio

DreamWorks Studios, Walt Disney Pictures

✅

✅

People Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Actors

actor

Chris Hemsworth, Margot Robbie

✅

✅

Directors

director

Steven Spielberg (Director), Olivia Wilde (Director)

✅

❌

Producers

producer

James Cameron (Producer), Reese Witherspoon (Producer)

✅

❌

Writers

writer

James Cameron (Writer), Lilly Wachowski (Writer)

✅

❌

Time Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Seasonal

seasonal

Easter, Christmas

✅

❌

Years

year

Best of 2010, Best of 2019

✅

✅

Decades Movie/Show

decade

Best of 2012, Best of 2022

✅

✅

Utility Collections

Default

Path

Example Collections

Works with Movies

Works with Shows

Collectionless

collectionless

Collectionless

✅

✅

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

seasonal

000

basic

010

anilist

020

imdb

020

flixpatrol

020

myanimelist

020

other_chart

020

tautulli

020

tmdb

020

trakt

020

streaming

030

universe

040

network

050

genre

060

studio

070

studio_anime

070

country

080

region

081

continent

082

based

085

audio_language

090

subtitle_language

095

decade

100

year

105

content_rating_us

110

content_rating_uk

110

content_rating_cs

110

resolution

120

aspect

125

bafta

130

cannes

130

choice

130

emmy

130

golden

130

oscars

130

other_award

130

spirit

130

sundance

130

actor

140

director

150

producer

160

writer

170

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: purple                               # use the purple separators globally for this library
      collection_mode: hide                         # hide the collections within the "library" tab in Plex.
      placeholder_imdb_id: tt8579674                # 1917 (2019) placeholder id for the separators, avoids a plex bug.
    metadata_path:
    - pmm: separator_award                          # An "index card"
    - pmm: bafta                                    # BAFTA Awards
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: golden                                   # Golden Globes Awards
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: oscars                                   # The Oscars
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: separator_chart                          # An "index card"
    - pmm: basic                                    # Some basic chart collections
    - pmm: tmdb                                     # TMDb Charts (Popular, Trending, etc.)
    - pmm: audio_language                           # English, French, Arabic, German, etc. audio language 
    - pmm: resolution                               # 4K HDR, 1080P FHD, etc. with the standards style 
      template_variables:
        style: standards
    - pmm: studio                                   # DreamWorks Studios, Lucasfilm Ltd, etc.
    - pmm: seasonal                                 # Christmas, Halloween, etc.
      template_variables:                           # Disable any US-specific seasonal collections
        schedule_independence: never
        schedule_thanksgiving: never
        schedule_memorial: never
        schedule_labor: never
    - pmm: streaming                                # Streaming on Disney+, Netflix, etc.
	  template_variables:
	    originals_only: true						# Only create collections for Original Content (i.e. Netflix Originals)
    - 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 - can cause image bloat
    # - reset_overlays: tmdb                          # if you want to reset the poster to default poster from tmdb - can cause image bloat
    - pmm: audio_codec                              # FLAC, DTS-X, TrueHD, etc. style: standard/compact. compact is default
    - pmm: resolution                               # 4K HDR, 1080P FHD, etc.
    - pmm: ribbon                                   # Used for ribbon in bottom right
    - pmm: streaming                                # Streaming on Disney+, Netflix, etc.
    - pmm: video_format                             # Remux, DVD, Blu-Ray, etc. in bottom left
    settings:
      asset_directory:
      - config/assets

    operations:
      split_duplicates: false
      assets_for_all: false

  TV Shows:                                         # Must match a library name in your Plex
    report_path: config/missing/TV_missing.yml
    template_variables:
      sep_style: plum                               # use the plum separators globally for this library
      collection_mode: hide                         # hide the collections within the "library" tab in Plex.
      placeholder_imdb_id: tt1190634                # The Boys (2019) placeholder id for the separators, avoids a plex bug.
    metadata_path:
    - pmm: separator_award                          # An "index card"
    - pmm: bafta                                    # BAFTA Awards
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: golden                                   # Golden Globes Awards
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: oscars                                   # The Oscars
      template_variables:                           # Show collections from current_year-10 onwards.
        data:
          starting: current_year-10
          ending: current_year
    - pmm: separator_chart                          # An "index card"
    - pmm: basic                                    # Some basic chart collections
    - pmm: tmdb                                     # TMDb Charts (Popular, Trending, etc.)
    - pmm: audio_language                           # English, French, Arabic, German, etc. audio language 
    - pmm: resolution                               # 4K HDR, 1080P FHD, etc. with the standards style 
      template_variables:
        style: standards
    - pmm: network                                  # ABC, CBC, NBC, FOX, etc.
    - pmm: streaming                                # Streaming on Disney+, Netflix, etc.
	  template_variables:
	    originals_only: true						# Only create collections for Original Content (i.e. Netflix Originals)
    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 - can cause image bloat
    # - reset_overlays: tmdb                          # if you want to reset the poster to default poster from tmdb - can cause image bloat
    - pmm: audio_codec                              # FLAC, DTS-X, TrueHD, etc. on show and episode
    - pmm: audio_codec
      template_variables:
        overlay_level: episode
    - pmm: episode_info                             # S##E## information in bottom right on episode
      template_variables:
        overlay_level: episode
    - pmm: resolution                               # 4K HDR, 1080P FHD, etc. on 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 on show
    - pmm: status                                   # Airing, Returning, Ended, Canceled on show
    - pmm: versions                                 # Will show duplicates for that media item on show and episode
    - pmm: versions                                 
      template_variables:
        overlay_level: episode
    - pmm: video_format                             # Remux, DVD, Blu-Ray, etc. in bottom left on show, episode, and season
    - pmm: video_format
      template_variables:
        overlay_level: episode
    settings:
      asset_directory:
      - config/assets

    operations:
      split_duplicates: false
      assets_for_all: false
playlist_files:
- pmm: playlist
  template_variables:
    libraries: Movies, TV Shows						# Must match the names of your libraries in Plex.