You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Plex-Meta-Manager/docs/defaults/both/resolution_standards.md

54 lines
3.2 KiB

# Resolution Standards Default Metadata File
The `- pmm: resolution_standards` Metadata File is used to dynamically create collections based on the resolutions available in your library.
This file takes the base resolutions ("4K" and "720p") and turns them into the commonly-known standards name ("Ultra HD" and "HD Ready")
To avoid duplication, this file should not be used in combination with `- pmm: resolution`
Example Collections Created:
![](../images/resolution_standards.png)
The below YAML in your config.yml will create the collections:
```yaml
libraries:
Movies:
metadata_path:
- pmm: resolution_standards
```
## Template Variables
Template Variables can be used to manipulate the file from the default settings which are provided.
Note that the `templates_variables:` section only needs to be used if you do NOT want to use the default settings.
All [Shared Variables](../variables) are available as well as the additional Variables below which can be used to customize the file.
| Variable | Description & Values |
|:-----------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `sort_by` | **Description:** Controls the sort method for the collections<br>**Values:** Any sort method in the [Sorts Options Table](#sort-options) |
| `include` | **Description:** Overrides the default include list<br>**Values:** Any Resolution found in your library |
| `exclude` | **Description:** Overrides the default exclude list<br>**Values:** Any Resolution found in your library |
| `addons` | **Description:** Defines how multiple keys can be combined under a parent key. The parent key doesn't have to already exist in Plex<br>**Values:** Any Resolution found in your library |
| `append_include` | **Description:** Appends to the existing include list<br>**Values:** Any Resolution found in your library |
| `append_exclude` | **Description:** Appends to the existing exclude list<br>**Values:** Any Resolution found in your library |
| `append_addons` | **Description:** Appends to the existing addons list<br>**Values:** Any Resolution found in your library |
The below shows an example config.yml with all the template_variables set away from their defaults:
```yaml
libraries:
Movies:
metadata_path:
- pmm: resolution_standards
template_variables:
exclude:
- HD Ready
sort_by: title.asc
collection_section: 16
collection_mode: show_items
use_separator: false
sep_style: stb
```