mirror of
https://github.com/meisnate12/Plex-Meta-Manager
synced 2024-12-25 20:33:05 +00:00
198 lines
8 KiB
Markdown
198 lines
8 KiB
Markdown
# Metadata Files
|
|
|
|
Metadata files are used to create and maintain collections and metadata within the Plex libraries on the server.
|
|
|
|
If utilized to their fullest, these files can be used to maintain the entire server's collections and metadata, and can be used as a backup for these in the event of a restore requirement.
|
|
|
|
Collections, templates, metadata, and dynamic collections are defined within one or more Metadata files, which are linked to libraries in the [Libraries Attribute](../config/libraries.md#metadata-path) within the [Configuration File](../config/configuration.md).
|
|
|
|
These are the attributes which can be used within the Metadata File:
|
|
|
|
| Attribute | Description |
|
|
|:--------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| [`templates`](templates) | contains definitions of templates that can be leveraged by multiple collections |
|
|
| [`external_templates`](templates.md#external-templates) | contains [path types](../config/paths) that point to external templates that can be leveraged by multiple collections |
|
|
| [`collections`](#collection-attributes) | contains definitions of collections you wish to add to one or more libraries |
|
|
| [`dynamic_collections`](#dynamic-collection-attributes) | contains definitions of [dynamic collections](dynamic) you wish to create |
|
|
| [`metadata`](#metadata-attributes) | contains definitions of metadata changes to [movie](metadata/movie), [show](metadata/show), or [music](metadata/music) library's items [movie titles, episode descriptions, etc.] |
|
|
|
|
* One of `metadata`, `collections` or `dynamic_collections` must be present for the Metadata File to execute.
|
|
* Example Metadata Files can be found in the [Plex Meta Manager Configs Repository](https://github.com/meisnate12/Plex-Meta-Manager-Configs/tree/master/PMM)
|
|
|
|
## Collection Attributes
|
|
|
|
Plex Meta Manager can run a number of different operations within `collections` and such as:
|
|
|
|
* Automatically build and update collections and playlists
|
|
* Sync the collection with the source list if one is used
|
|
* Send missing media to Sonarr/Radarr (Lidarr not supported at this time)
|
|
* Show and Hide collections at set intervals (i.e. show Christmas collections in December only)
|
|
|
|
Each collection requires its own section within the `collections` attribute and unlike playlists, collections can be built using as many Builders as needed.
|
|
|
|
```yaml
|
|
collections:
|
|
Trending Movies:
|
|
# ... builders, details, and filters for this collection
|
|
Popular Movies:
|
|
# ... builders, details, and filters for this collection
|
|
etc:
|
|
# ... builders, details, and filters for this collection
|
|
```
|
|
|
|
There are three types of attributes that can be utilized within a collection:
|
|
|
|
### Builders
|
|
|
|
Builders use third-party services to source items to be added to the collection. Multiple builders can be used in the same collection from a variety of sources listed below.
|
|
|
|
* [Plex Builders](builders/plex)
|
|
* [Smart Builders](builders/smart) (Collections Only)
|
|
* [TMDb Builders](builders/tmdb)
|
|
* [TVDb Builders](builders/tvdb)
|
|
* [IMDb Builders](builders/imdb)
|
|
* [Trakt Builders](builders/trakt)
|
|
* [Tautulli Builders](builders/tautulli)
|
|
* [Radarr Builders](builders/radarr)
|
|
* [Sonarr Builders](builders/sonarr)
|
|
* [MdbList Builders](builders/mdblist)
|
|
* [Letterboxd Builders](builders/letterboxd)
|
|
* [ICheckMovies Builders](builders/icheckmovies)
|
|
* [FlixPatrol Builders](builders/flixpatrol)
|
|
* [Reciperr Builders](builders/reciperr)
|
|
* [StevenLu Builders](builders/stevenlu)
|
|
* [AniDB Builders](builders/anidb)
|
|
* [AniList Builders](builders/anilist)
|
|
* [MyAnimeList Builders](builders/myanimelist)
|
|
|
|
### Details
|
|
|
|
These can alter any aspect of the collection or the media items within them.
|
|
|
|
* [Setting Details](details/setting)
|
|
* [Schedule Detail](details/schedule)
|
|
* [Metadata Details](details/metadata)
|
|
* [Arr Details](details/arr)
|
|
|
|
### Filters
|
|
|
|
These filter media items added to the collection by any of the Builders.
|
|
|
|
* [Filters](filters)
|
|
|
|
### Example
|
|
|
|
```yaml
|
|
collections:
|
|
Trending:
|
|
trakt_trending: 10
|
|
tmdb_trending_daily: 10
|
|
tmdb_trending_weekly: 10
|
|
sort_title: +1_Trending
|
|
sync_mode: sync
|
|
smart_label: random
|
|
summary: Movies Trending across the internet
|
|
Popular:
|
|
tmdb_popular: 40
|
|
imdb_list:
|
|
url: https://www.imdb.com/search/title/?title_type=feature,tv_movie,documentary,short
|
|
limit: 40
|
|
sort_title: +2_Popular
|
|
sync_mode: sync
|
|
smart_label: random
|
|
summary: Popular Movies across the internet
|
|
```
|
|
|
|
## Dynamic Collection Attributes
|
|
|
|
Plex Meta Manager can dynamically create collections based on a verity of different criteria, such as
|
|
|
|
* Collections for the top `X` popular people on TMDb (Bruce Willis, Tom Hanks etc.)
|
|
* Collections for each decade represented in the library (Best of 1990s, Best of 2000s etc.)
|
|
* Collections for each of the moods/styles within a Music library (A Cappella, Pop Rock etc.)
|
|
* Collections for each of a Trakt Users Lists.
|
|
|
|
Below is an example dynamic collection which will create a collection for each of the decades represented within the library:
|
|
|
|
```yaml
|
|
dynamic_collections:
|
|
Decades:
|
|
type: decade
|
|
```
|
|
|
|
## Metadata Attributes
|
|
|
|
Plex Meta Manager can automatically update items in Plex [Movie](metadata/movie), [Show](metadata/movie), and [Music](metadata/movie) Libraries based on what's defined within the `metadata` attribute.
|
|
|
|
Each metadata requires its own section within the `metadata` attribute. Each item is defined by the mapping name which must be the same as the item name in the library unless an `alt_title` is specified.
|
|
|
|
```yaml
|
|
metadata:
|
|
Godzilla vs. Mechagodzilla II:
|
|
# ... details to change for this itwm
|
|
Godzilla vs. Megaguirus:
|
|
# ... details to change for this itwm
|
|
Godzilla vs. Megalon:
|
|
# ... details to change for this itwm
|
|
Halloween (Rob Zombie):
|
|
# ... details to change for this itwm
|
|
etc:
|
|
# ... details to change for this itwm
|
|
```
|
|
|
|
### Title & Year
|
|
|
|
YAML files cannot have two items with the same mapping name so if you have two movies with the same name you define each one with a name of your choosing. Then use the `title` attribute to specify the real title and the `year` attribute to specify which of the multiple movies is for this mapping.
|
|
|
|
```yaml
|
|
metadata:
|
|
Godzilla1:
|
|
title: Godzilla
|
|
year: 1954
|
|
content_rating: R
|
|
Godzilla2:
|
|
title: Godzilla
|
|
year: 1998
|
|
content_rating: PG-13
|
|
```
|
|
|
|
### Alt Title
|
|
|
|
To define an alternative title that the item may be called when searching use `alt_title`. When a title is found matching `alt_title` then the name of the itme will be changed to match the mapping name or `title` if specified.
|
|
|
|
For Example, the 2007 movie Halloween shares a name with another movie in the Halloween franchise so this changes the title to `Halloween (Rob Zombie)` if the title is currently Halloween.
|
|
|
|
```yaml
|
|
metadata:
|
|
Halloween (Rob Zombie):
|
|
alt_title: Halloween
|
|
year: 2007
|
|
```
|
|
|
|
### Example
|
|
|
|
```yaml
|
|
metadata:
|
|
Godzilla1:
|
|
title: Godzilla
|
|
year: 1954
|
|
content_rating: R
|
|
Godzilla2:
|
|
title: Godzilla
|
|
year: 1998
|
|
content_rating: PG-13
|
|
Godzilla vs. Mechagodzilla II:
|
|
content_rating: PG
|
|
Godzilla vs. Megaguirus:
|
|
content_rating: PG
|
|
originally_available: 2000-08-31
|
|
Godzilla vs. Megalon:
|
|
content_rating: G
|
|
originally_available: 1973-03-17
|
|
Halloween (Rob Zombie):
|
|
alt_title: Halloween
|
|
year: 2007
|
|
```
|
|
|
|
|
|
|