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.
169 lines
16 KiB
169 lines
16 KiB
# TV Show Library Metadata
|
|
|
|
You can have the script edit the metadata of Shows, Seasons, and Episodes by adding them to the `metadata` mapping of a Metadata File.
|
|
|
|
An example of multiple metadata edits in a show library is below:
|
|
```yaml
|
|
metadata:
|
|
"Avatar: The Last Airbender":
|
|
sort_title: Avatar 01
|
|
seasons:
|
|
1:
|
|
title: "Book One: Water"
|
|
summary: >-
|
|
After a lapse of 100 years, the Avatar-spiritual master of the elements-has returned. And just in
|
|
the nick of time. The Four Nations (Water, Earth, Fire, and Air) have become unbalanced. The Fire
|
|
Nation wants to rule the world, and its first conquest will be the Northern Water Tribe. It's up to
|
|
a 12-year-old Airbender named Aang to find a way to stop it. Join Aang, Katara, Sokka, Momo, and
|
|
Appa as they head north on the adventure of a lifetime.
|
|
episodes:
|
|
1:
|
|
user_rating: 9.1
|
|
2:
|
|
title: "Book Two: Earth"
|
|
summary: >-
|
|
Avatar Aang continues his quest to master the four elements before the end of summer. Together with
|
|
Katara, Sokka, Momo, and Appa, he journeys across the Earth Kingdom in search of an Earthbending
|
|
mentor. Along the way, he confronts Princess Azula, treacherous daughter of Firelord Ozai and
|
|
sister to Prince Zuko. More powerful than her brother, Azula will stop nothing to defeat the Avatar.
|
|
But Aang and the gang find plenty of Earth Kingdom allies to help them along the way. From the swamps
|
|
of the South to the Earth King's palace, Avatar: Book 2 is an adventure like no other.
|
|
3:
|
|
title: "Book Three: Fire"
|
|
summary: >-
|
|
Having survived the terrible battle with Azula, Aang faces new challenges as he and his brave
|
|
friends secretly enter the Fire Nation. Their quest is to find and defeat Firelord Ozai. Along
|
|
the way, they discover that Ozai has plans of his own. The leader of the Fire Nation intends to
|
|
use the massive power of Sozin's comet to spread his dominion permanently across the four nations.
|
|
Short on time, Aang has a lot of bending to learn and no master to help him learn it. However, his
|
|
friends are there to help, and he finds unexpected allies deep in the heart of the Fire Nation. In
|
|
the spectacular four-part conclusion, Aang must fulfill his destiny and become a fully realized
|
|
Avatar, or watch the world go up in smoke.
|
|
episodes:
|
|
21:
|
|
summary: The Epic Series Final of Avatar The Last Airbender
|
|
"Avatar: The Legend of Korra":
|
|
sort_title: Avatar 02
|
|
alt_title: The Legend of Korra
|
|
original_title: The Legend of Korra
|
|
seasons:
|
|
1:
|
|
title: "Book One: Air"
|
|
2:
|
|
title: "Book Two: Spirits"
|
|
3:
|
|
title: "Book Three: Change"
|
|
4:
|
|
title: "Book Four: Balance"
|
|
```
|
|
|
|
## Shows
|
|
|
|
Each metadata definition is defined by the mapping name which can link to a show in multiple ways.
|
|
|
|
* Mapping name must match the show name in Plex exactly unless an `alt_title` is specified.
|
|
* Mapping name must match the TVDb ID or IMDb ID mapped to the show.
|
|
|
|
**Note:** to search for a show titled with a number surround the number in quotes like in the example below.
|
|
|
|
```yaml
|
|
metadata:
|
|
Game of Thrones: # Matches via the Name "Game of Thrones"
|
|
edits...
|
|
366524: # Matches via TVDb ID: 366524
|
|
edits...
|
|
tt10234724: # Matches via IMDb ID: tt10234724
|
|
edits...
|
|
"24": # Matches via the Name "24"
|
|
edits...
|
|
```
|
|
|
|
### Seasons
|
|
|
|
To edit the metadata of a particular Season in a Show use the `seasons` attribute on its show.
|
|
|
|
The mapping name is the season number (use 0 for specials) or the season name.
|
|
|
|
### Episodes
|
|
|
|
To edit the metadata of a particular Episode in a Season use the `episodes` attribute on its season.
|
|
|
|
The mapping name is the episode number in that season, the title of the episode, or the Originally Available date in the format `MM/DD`.
|
|
|
|
## Metadata Edits
|
|
|
|
The available attributes for editing shows, seasons, and episodes are as follows
|
|
|
|
### Special Attributes
|
|
|
|
| Attribute | Values | Shows | Seasons | Episodes |
|
|
|:------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------:|:--------:|:--------:|
|
|
| `title` | Title if different from the mapping value useful when you have multiple shows with the same name. See the [Metadata Page](../metadata.md#metadata-attributes) for how searching for files works. | ✅ | ✅ | ✅ |
|
|
| `alt_title` | Alternative title to look for and then change to the mapping name. See the [Metadata Page](../metadata.md#metadata-attributes) for how searching for files works. | ✅ | ❌ | ❌ |
|
|
| `year` | Year of show for better identification. See the [Metadata Page](../metadata.md#metadata-attributes) for how searching for files works. | ✅ | ❌ | ❌ |
|
|
| `tmdb_show` | TMDb Show ID to use for metadata useful for miniseries that have been compiled into a movie | ✅ | ❌ | ❌ |
|
|
| `tmdb_movie` | TMDb Movie ID to use for metadata useful for movies that have been split into segments | ✅ | ❌ | ❌ |
|
|
| `f1_season` | F1 Season Year to make the Show represent a Season of F1 Races. See [Formula 1 Metadata Guide](../../home/guides/formula) for more information. | ✅ | ❌ | ❌ |
|
|
| `round_prefix` | Used only with `f1_season` to add the round as a prefix to the Season (Race) Titles i.e. `Australian Grand Prix` --> `01 - Australian Grand Prix` | ✅ | ❌ | ❌ |
|
|
| `shorten_gp` | Used only with `f1_season` to shorten `Grand Prix` to `GP` in the Season (Race) Titles i.e. `Australian Grand Prix` --> `Australian GP` | ✅ | ❌ | ❌ |
|
|
| `seasons` | Mapping to define Seasons | ✅ | ❌ | ❌ |
|
|
| `episodes` | Mapping to define Episodes | ❌ | ✅ | ❌ |
|
|
| `run_definition` | Used to specify if this definition runs.<br>Multiple can be used for one definition as a list or comma separated string. One `false` or unmatched library type will cause it to fail.<br>**Values:** `movie`, `show`, `artist`, `true`, `false` | ✅ | ❌ | ❌ |
|
|
| `update_seasons` | Used to specify if this definition's seasons metadata will update.<br>Multiple can be used for one definition as a list or comma separated string. One `false` will cause it to fail.<br>**Values:** `true`, `false` | ✅ | ❌ | ❌ |
|
|
| `update_episodes` | Used to specify if this definition's episodes metadata will update.<br>Multiple can be used for one definition as a list or comma separated string. One `false` will cause it to fail.<br>**Values:** `true`, `false` | ✅ | ❌ | ❌ |
|
|
|
|
### General Attributes
|
|
|
|
| Attribute | Values | Shows | Seasons | Episodes |
|
|
|:-----------------------|:--------------------------------------------------------------|:--------:|:--------:|:--------:|
|
|
| `title` | Text to change Title | ❌ | ✅ | ✅ |
|
|
| `sort_title` | Text to change Sort Title | ✅ | ❌ | ✅ |
|
|
| `original_title` | Text to change Original Title | ✅ | ❌ | ❌ |
|
|
| `originally_available` | Date to change Originally Available<br>**Format:** YYYY-MM-DD | ✅ | ❌ | ✅ |
|
|
| `content_rating` | Text to change Content Rating | ✅ | ❌ | ✅ |
|
|
| `user_rating` | Number to change User Rating | ✅ | ✅ | ✅ |
|
|
| `audience_rating` | Number to change Audience Rating | ✅ | ❌ | ✅ |
|
|
| `critic_rating` | Number to change Critic Rating | ✅ | ❌ | ✅ |
|
|
| `studio` | Text to change Studio | ✅ | ❌ | ❌ |
|
|
| `tagline` | Text to change Tagline | ✅ | ❌ | ❌ |
|
|
| `summary` | Text to change Summary | ✅ | ✅ | ✅ |
|
|
|
|
### Tag Attributes
|
|
|
|
You can add `.remove` to any tag attribute to only remove those tags i.e. `genre.remove`.
|
|
|
|
You can add `.sync` to any tag attribute to sync all tags vs just appending the new ones i.e. `genre.sync`.
|
|
|
|
| Attribute | Values | Shows | Seasons | Episodes |
|
|
|:-------------|:----------------------------------------------------|:--------:|:--------:|:--------:|
|
|
| `director` | List or comma-separated text of each Director Tag | ❌ | ❌ | ✅ |
|
|
| `genre` | List or comma-separated text of each Genre Tag | ✅ | ❌ | ❌ |
|
|
| `writer` | List or comma-separated text of each Writer Tag | ❌ | ❌ | ✅ |
|
|
| `collection` | List or comma-separated text of each Collection Tag | ✅ | ✅ | ✅ |
|
|
| `label` | List or comma-separated text of each Label Tag | ✅ | ✅ | ✅ |
|
|
|
|
### Image Attributes
|
|
|
|
| Attribute | Values | Shows | Seasons | Episodes |
|
|
|:------------------|:------------------------------------------------|:-------:|:-------:|:--------:|
|
|
| `url_poster` | URL of image publicly available on the internet | ✅ | ✅ | ✅ |
|
|
| `file_poster` | Path to image in the file system | ✅ | ✅ | ✅ |
|
|
| `url_background` | URL of image publicly available on the internet | ✅ | ✅ | ✅ |
|
|
| `file_background` | Path to image in the file system | ✅ | ✅ | ✅ |
|
|
|
|
### Advanced Attributes
|
|
|
|
All these attributes only work with Shows.
|
|
|
|
| Attribute | Values |
|
|
|:---------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `episode_sorting` | <table class="clearTable"><tbody><tr><td>`default`</td><td>Library default</td></tr><tr><td>`oldest`</td><td>Oldest first</td></tr><tr><td>`newest`</td><td>Newest first</td></tr></tbody></table> |
|
|
| `keep_episodes` | <table class="clearTable"><tbody><tr><td>`all`</td><td>All episodes</td></tr><tr><td>`5_latest`</td><td>5 latest episodes</td></tr><tr><td>`3_latest`</td><td>3 latest episodes</td></tr><tr><td>`latest`</td><td>Latest episodes</td></tr><tr><td>`past_3`</td><td>Episodes added in the past 3 days</td></tr><tr><td>`past_7`</td><td>Episodes added in the past 7 days</td></tr><tr><td>`past_30`</td><td>Episodes added in the past 30 days</td></tr></tbody></table> |
|
|
| `delete_episodes` | <table class="clearTable"><tbody><tr><td>`never`</td><td>Never</td></tr><tr><td>`day`</td><td>After a day</td></tr><tr><td>`week`</td><td>After a week</td></tr><tr><td>`refresh`</td><td>On next refresh</td></tr></tbody></table> |
|
|
| `season_display` | <table class="clearTable"><tbody><tr><td>`default`</td><td>Library default</td></tr><tr><td>`show`</td><td>Show</td></tr><tr><td>`hide`</td><td>Hide</td></tr></tbody></table> |
|
|
| `episode_ordering` | <table class="clearTable"><tbody><tr><td>`default`</td><td>Library default</td></tr><tr><td>`tmdb_aired`</td><td>The Movie Database (Aired)</td></tr><tr><td>`tvdb_aired`</td><td>TheTVDb (Aired)</td></tr><tr><td>`tvdb_dvd`</td><td>TheTVDb (DVD)</td></tr><tr><td>`tvdb_absolute`</td><td>TheTVDb (Absolute)</td></tr></tbody></table> |
|
|
| `metadata_language`<sup>1</sup> | `default`, `ar-SA`, `ca-ES`, `cs-CZ`, `da-DK`, `de-DE`, `el-GR`, `en-AU`, `en-CA`, `en-GB`, `en-US`, `es-ES`, `es-MX`, `et-EE`, `fa-IR`, `fi-FI`, `fr-CA`, `fr-FR`, `he-IL`, `hi-IN`, `hu-HU`, `id-ID`, `it-IT`, `ja-JP`, `ko-KR`, `lt-LT`, `lv-LV`, `nb-NO`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sv-SE`, `th-TH`, `tr-TR`, `uk-UA`, `vi-VN`, `zh-CN`, `zh-HK`, `zh-TW` |
|
|
| `use_original_title`<sup>1</sup> | <table class="clearTable"><tbody><tr><td>`default`</td><td>Library default</td></tr><tr><td>`no`</td><td>No</td></tr><tr><td>`yes`</td><td>Yes</td></tr></tbody></table> |
|
|
|
|
<sup>1</sup> Must be using the **New Plex TV Agent**
|