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

2.7 KiB

Defaults Usage Guide

Plex Meta Manager includes a pre-created set of Collection Files and Overlay Files which can be found in the "defaults" folder in the root of your Plex Meta Manager installation directory.

These files offer an easy-to-use and customizable set of Collections and Overlays that the user can achieve without having to worry about creating the files that make the collections and overlays possible.

All Collections come with a matching poster to make a clean, consistent set of collections in your library. These files are stored in the Plex Meta Manager Images Repository and each poster is downloaded straight to your Plex Collection when you run Plex Meta Manager.

Credits to Sohjiro, Bullmoose20, Yozora, Cpt Kuesel, and anon_fawkes for helping drive this entire Default Set of Configs through the concept, design and implementation.

Special thanks to Magic815 for the overlay image inspiration and base template.

Please consider donating towards the project.

Collection Defaults

See the Collection Defaults Page for more information on the specifics of the Collection Defaults.

Overlay Defaults

See the Overlay Defaults Page for more information on the specifics of the Overlay Defaults.

Configurations

To run a default pmm Metadata or Overlay file you can simply add it to your collection_files (For Collection Files) or overlay_files (For Overlay Files) using pmm like so:

libraries:
  Movies:
    collection_files:
    - pmm: actor
    - pmm: genre
    overlay_files:
    - pmm: ribbon
    - pmm: ratings

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:
    collection_files:
      - pmm: imdb
        template_variables:
          use_popular: false
          use_lowest: false
          visible_library_top: true
          visible_home_top: true
          visible_shared_top: true
    overlay_files:
      - pmm: ratings
        template_variables:
          builder_level: episode

Each file has a page on the wiki showing the available template_variables for each file. For example the default pmm: ratings has a page here.

In addition to the defined template_variables almost all default Metadata and Overlay files have access to their respective Metadata/Overlay Shared Variables.

{% include-markdown "./example.md" %}