Plex-Meta-Manager/docs/defaults/both/resolution_standards.md

54 lines
3.2 KiB
Markdown
Raw Normal View History

2022-09-27 15:08:18 +00:00
# Resolution Standards Default Metadata File
The `resolution_standards` Metadata File is used to dynamically create collections based on the resolutions available in your library.
2022-09-27 15:08:18 +00:00
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)
2022-09-27 15:08:18 +00:00
2022-09-27 22:01:34 +00:00
The below YAML in your config.yml will create the collections:
2022-09-27 15:08:18 +00:00
```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.
2022-10-06 19:01:28 +00:00
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 |
2022-09-27 15:08:18 +00:00
The below is an example config.yml extract with some template_variables changed from their defaults.
2022-09-27 15:08:18 +00:00
```yaml
libraries:
Movies:
metadata_path:
- pmm: resolution_standards
template_variables:
2022-10-06 19:01:28 +00:00
exclude:
- HD Ready
2022-09-27 15:08:18 +00:00
sort_by: title.asc
collection_section: 16
collection_mode: show_items
use_separator: false
sep_style: stb
2022-10-06 19:01:28 +00:00
```