><><>>><>"` and so for `genre.yml` if you have a `Fantasy` collection, plex is going to show `!06_Fantasy`
This is the default PMM collection ordering:
| Collection | Order |
|:-------------------------------------|------------------------|
| `PMM/movie/seasonal.yml` | collection_section: 00 |
| `PMM/chart/anilist.yml` | collection_section: 01 |
| `PMM/chart/basic.yml` | collection_section: 01 |
| `PMM/chart/imdb.yml` | collection_section: 01 |
| `PMM/chart/myanimelist.yml` | collection_section: 01 |
| `PMM/chart/other.yml` | collection_section: 01 |
| `PMM/chart/tautulli.yml` | collection_section: 01 |
| `PMM/chart/tmdb.yml` | collection_section: 01 |
| `PMM/chart/trakt.yml` | collection_section: 01 |
| `PMM/movie/universe.yml` | collection_section: 02 |
| `PMM/streaming.yml` | collection_section: 03 |
| `PMM/show/network.yml` | collection_section: 04 |
| `PMM/genre.yml` | collection_section: 06 |
| `PMM/studio.yml` | collection_section: 07 |
| `PMM/movie/country.yml` | collection_section: 09 |
| `PMM/show/country.yml` | collection_section: 09 |
| `PMM/audio_language.yml` | collection_section: 10 |
| `PMM/subtitle_language.yml` | collection_section: 11 |
| `PMM/movie/decade.yml` | collection_section: 12 |
| `PMM/show/decade.yml` | collection_section: 12 |
| `PMM/year.yml` | collection_section: 13 |
| `PMM/content_rating_uk.yml` | collection_section: 14 |
| `PMM/movie/content_rating_us.yml` | collection_section: 14 |
| `PMM/show/content_rating_us.yml` | collection_section: 14 |
| `PMM/resolution.yml` | collection_section: 15 |
| `PMM/resolution_standards.yml` | collection_section: 15 |
| `PMM/award/bafta.yml` | collection_section: 16 |
| `PMM/award/cannes.yml` | collection_section: 16 |
| `PMM/award/choice.yml` | collection_section: 16 |
| `PMM/award/emmy.yml` | collection_section: 16 |
| `PMM/award/golden.yml` | collection_section: 16 |
| `PMM/award/oscars.yml` | collection_section: 16 |
| `PMM/award/other.yml` | collection_section: 16 |
| `PMM/award/separator.yml` | collection_section: 16 |
| `PMM/award/spirit.yml` | collection_section: 16 |
| `PMM/award/sundance.yml` | collection_section: 16 |
| `PMM/actor.yml` | collection_section: 17 |
| `PMM/movie/director.yml` | collection_section: 18 |
| `PMM/movie/producer.yml` | collection_section: 19 |
| `PMM/movie/writer.yml` | collection_section: 20 |
## Ratings Overlays
By default for Movies in Plex, the `Ratings Source` dropdown (`#3`) below, can come from Rotten Tomatoes (and includes Critic Ratings and Audience Ratings) or IMDb (Audience Ratings). This only changes the tiny icons displayed and where Plex will retrieve the ratings from upon initial scan and import of the media metadata.
**Plex Meta Manager can insert up to three ratings of your choice into the three spots regardless of what you choose in the `Advanced` tab of that Plex library**
![](ratings_source.png)
Plex has three available spots in the Plex DB to store ratings and thus Plex Meta Manager can be used to insert ratings sources of your choice into those spots. They are known as the User Rating (`#1`), Critic Rating (`#2`), and Audience Rating (`#3`).
**Note that the little icons cannot be changed and that the numbers next to the little icons are reflected in the poster ratings overlay**
![](ratings_spot.png)
To be able to insert the ratings you want, Plex Meta Manager operations need to be defined. In this example below, User ratings (`#1`) are being filled with Rotten Tomatoes Critics Ratings. Critic ratings (`#2`) are filled with IMDb, and Audience ratings (`#3`) are filled with TMDb.
**mass_*_rating_update** sources can be found here: [operations](../../config/operations)
![](ratings_operations.png)
Finally, to show the ratings on the poster, the following was added to the `overlay_path` section in the `config.yml` file to post Rotten Tomatoes Critics Ratings in (`#1`), IMDb ratings in (`#2`), and TMDb ratings in (`#3`)
![](ratings_overlay_path.png)
## 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.
```yaml
libraries:
TV Shows:
overlay_path:
- pmm: overlays/ratings
template_variables:
overlay_level: episode
```
Each file has a comment block at the top showing the available `template_variables` for each file. For example the [`PMM/genre`](https://github.com/meisnate12/Plex-Meta-Manager-Configs/blob/master/PMM/genre.yml) has this:
```yaml
#############################################################
# Dynamic Genre Collections #
# Created by Yozora, Bullmoose20, & Sohjiro #
#############################################################
# Call this from your config.yml (Movie or Show) #
# If nothing is specified these are the defaults #
# #
# metadata_path: #
# - pmm: genre #
# template_variables: #
# # Turn the separator collection on/off #
# use_separator: true #
# # Sets how the collection is sorted #
# sort_by: release.desc #
# # Sets the collection mode of the collection #
# collection_mode: #
# # Sets the value at the start of the sort title #
# collection_section: "06" #
#############################################################
```
Each of these when passed will change how the collection runs slightly.
* `use_separator` Turn the separator collection on/off
* `sort_by` Sets how the collection is sorted
* `collection_mode` Sets the collection mode of the collection
* `collection_section` Sets the value at the start of the sort title
**In addition to the defined `template_variables` each file in the PMM Folder has access to the `radarr_add_missing` and `sonarr_add_missing` template variables and for dynamic collections most attributes can be passed as template variables**
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.
```yaml
libraries:
Movies:
metadata_path:
- pmm: award/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.
```yaml
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.
```yaml
libraries:
Movies:
metadata_path:
- pmm: genre
template_variables:
collection_section: 11
```
Or maybe you want to disable separators globally per library.
```yaml
libraries:
LIBRARYNAME:
template_variables:
use_separator: false
metadata_path:
```
Alternatively it can be turned off individually per git file:
```yaml
libraries:
LIBRARYNAME:
metadata_path:
- pmm: # separator is disabled
template_variables:
use_separator: false
- pmm: # separator is enabled by default
- pmm: # separator is disabled
template_variables:
use_separator: false
```
## Errors
If there are collections being made that have configuration errors or missing posters please either bring it up in our Discord or raise an Issue on the [Configs Repo](https://github.com/meisnate12/Plex-Meta-Manager-Configs/issues/new/choose).
## Example Configuration File
Click to expand sample config.yml file:
```yaml
libraries:
Movies:
metadata_path:
- pmm: award/bafta
- pmm: award/cannes
- pmm: award/choice
- pmm: award/golden
- pmm: award/oscars
- pmm: award/other
- pmm: award/spirit
- pmm: award/sundance
- pmm: chart/anilist
- pmm: chart/basic
- pmm: chart/imdb
- pmm: chart/myanimelist
- pmm: chart/other
- pmm: chart/tautulli
- pmm: chart/tmdb
- pmm: chart/trakt
- pmm: actor
- pmm: audio_language
- pmm: movie/content_rating_us # Choose content_rating_uk or content_rating_us
- pmm: genre
- pmm: resolution_standards # Choose resolution_standards or resolution
- pmm: streaming
- pmm: studio
- pmm: subtitle_language
- pmm: year
- pmm: movie/country
- pmm: movie/decade
- pmm: movie/director
- pmm: movie/franchise
- pmm: movie/universe
- pmm: movie/producer
- pmm: movie/seasonal
- pmm: movie/writer
overlay_path:
- remove_overlays: false
- pmm: overlays/audio_codec
- pmm: overlays/audio_language
- pmm: overlays/commonsense
- pmm: overlays/direct_play
- pmm: overlays/mediastinger
- pmm: overlays/imdb_top_250
- pmm: overlays/mc_must_see
- pmm: overlays/rt_cert_fresh
- pmm: overlays/commonsense_selection
- pmm: overlays/ratings
template_variables:
rating1: critic
rating1_image: rt_tomato
- pmm: overlays/resolution
- pmm: overlays/special_release
- pmm: overlays/streaming
- pmm: overlays/versions
- pmm: overlays/video_format
TV Shows:
metadata_path:
- pmm: award/choice
- pmm: award/golden
- pmm: award/emmy
- pmm: chart/anilist
- pmm: chart/basic
- pmm: chart/imdb
- pmm: chart/myanimelist
- pmm: chart/other
- pmm: chart/tautulli
- pmm: chart/tmdb
- pmm: chart/trakt
- pmm: actor
- pmm: audio_language
- pmm: show/content_rating_us # Choose content_rating_uk or content_rating_us
- pmm: genre
- pmm: resolution_standards # Choose resolution_standards or resolution
- pmm: streaming
- pmm: studio
- pmm: subtitle_language
- pmm: year
- pmm: show/country
- pmm: show/decade
- pmm: show/network
overlay_path:
- remove_overlays: false
- pmm: overlays/audio_codec
- pmm: overlays/audio_codec
template_variables:
overlay_level: episode
- pmm: overlays/audio_codec
template_variables:
overlay_level: season
- pmm: overlays/audio_language
- pmm: overlays/audio_language
template_variables:
overlay_level: episode
- pmm: overlays/audio_language
template_variables:
overlay_level: season
- pmm: overlays/commonsense
- pmm: overlays/commonsense
template_variables:
overlay_level: episode
- pmm: overlays/commonsense
template_variables:
overlay_level: season
- pmm: overlays/direct_play
- pmm: overlays/direct_play
template_variables:
overlay_level: episode
- pmm: overlays/direct_play
template_variables:
overlay_level: season
- pmm: overlays/episode_info
template_variables:
overlay_level: episode
- pmm: overlays/mediastinger
- pmm: overlays/mediastinger
template_variables:
overlay_level: episode
- pmm: overlays/mediastinger
template_variables:
overlay_level: season
- pmm: overlays/imdb_top_250
- pmm: overlays/imdb_top_250
template_variables:
overlay_level: episode
- pmm: overlays/imdb_top_250
template_variables:
overlay_level: season
- pmm: overlays/mc_must_see
- pmm: overlays/mc_must_see
template_variables:
overlay_level: episode
- pmm: overlays/mc_must_see
template_variables:
overlay_level: season
- pmm: overlays/rt_cert_fresh
- pmm: overlays/rt_cert_fresh
template_variables:
overlay_level: episode
- pmm: overlays/rt_cert_fresh
template_variables:
overlay_level: season
- pmm: overlays/commonsense_selection
- pmm: overlays/commonsense_selection
template_variables:
overlay_level: episode
- pmm: overlays/commonsense_selection
template_variables:
overlay_level: season
- pmm: overlays/ratings
template_variables:
rating2: audience
rating2_image: imdb
- pmm: overlays/ratings
template_variables:
rating2: audience
rating2_image: imdb
overlay_level: episode
- pmm: overlays/resolution
- pmm: overlays/resolution
template_variables:
overlay_level: episode
- pmm: overlays/resolution
template_variables:
overlay_level: season
- pmm: overlays/runtimes
template_variables:
overlay_level: episode
- pmm: overlays/special_release
- pmm: overlays/special_release
template_variables:
overlay_level: episode
- pmm: overlays/special_release
template_variables:
overlay_level: season
- pmm: overlays/streaming
- pmm: overlays/versions
- pmm: overlays/versions
template_variables:
overlay_level: episode
- pmm: overlays/versions
template_variables:
overlay_level: season
- pmm: overlays/versions
template_variables:
overlay_level: show
- pmm: overlays/video_format
- pmm: overlays/video_format
template_variables:
overlay_level: episode
- pmm: overlays/video_format
template_variables:
overlay_level: season
playlist_files:
- pmm: playlist
```