Plex
/
Plex-Meta-Manager
mirror of https://github.com/meisnate12/Plex-Meta-Manager.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
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.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'f9b1fb5bd2'
${ noResults }
Plex-Meta-Manager/docs/metadata/metadata/movie.md

13 KiB
Raw Blame History

Movie Library Metadata

You can have the script edit the metadata of Movies by adding them to the metadata mapping of a Metadata File.

An example of multiple metadata edits in a movie library is below:

metadata:
  Godzilla (1954):
    match:
      title: Godzilla
      year: 1954
    content_rating: R
  Godzilla (1998):
    match:
      title: Godzilla
      year: 1998
    sort_title: Godzilla 03
    content_rating: PG-13
  Shin Godzilla:
    sort_title: Godzilla 06
    content_rating: R
  Godzilla 1985:
    content_rating: PG
  "Godzilla 2000: Millennium":
    originally_available: 1999-08-18
  Godzilla Against MechaGodzilla:
    originally_available: 2002-03-23
  Godzilla Raids Again:
    content_rating: G
    originally_available: 1955-05-21
  Godzilla vs. Biollante:
    content_rating: PG
  Godzilla vs. Destoroyah:
    content_rating: PG
    originally_available: 1995-01-19
  Godzilla vs. Gigan:
    content_rating: G
    originally_available: 1972-09-14
  Godzilla vs. Hedorah:
    content_rating: G
    originally_available: 1971-04-01
  Godzilla vs. King Ghidorah:
    content_rating: PG
    originally_available: 1991-04-28
  Godzilla vs. Mechagodzilla:
    content_rating: G
    originally_available: 1974-03-24
  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
  Godzilla vs. Mothra:
    content_rating: PG
    originally_available: 1992-04-28
  Godzilla vs. SpaceGodzilla:
    content_rating: PG
    originally_available: 1994-01-19
  Godzilla, King of the Monsters!:
    content_rating: G
  "Godzilla, Mothra and King Ghidorah: Giant Monsters All-Out Attack":
    content_rating: PG
    originally_available: 2001-08-31
  "Godzilla: Final Wars":
    content_rating: PG
    originally_available: 2004-12-13
  "Godzilla: Tokyo S.O.S.":
    originally_available: 2003-12-14
  Halloween (Rob Zombie):
    match:
      title: 
        - Halloween (Rob Zombie)
        - Halloween
    year: 2007
  "Halo 4: Forward Unto Dawn":
    match:
      title:
        - Halo 4: Forward Unto Dawn
        - Halo 4 Forward Unto Dawn
    tmdb_show: 56295
    content_rating: R

Matching Movies

The match attribute is used to match movies within Plex to that definition within the Metadata file. One definition can match and edit multiple movies. The available matching options are outlined below.

Attribute Description
title1 Only matches movies that exactly match the movie's Title. Can be a list (only one needs to match).
year Only matches movies that were released in the given year.
mapping_id2 Only matches movies that have the given TMDb or IMDb ID.
edition3 Only matches movies that exactly match the movie's Edition. Can be a list (only one needs to match).
edition_contains3 Only matches movies where the movie's Edition contains the given string. Can be a list (only one needs to match).
blank_edition3 Only matches movies that have no Edition.
Default: false
Values: true or false
  1. When title is not provided and the mapping name was not specified as an ID, the default behaviour is to use the mapping name as title for matching.
  2. When mapping_id is not provided and the mapping name was specified as an ID, the default behaviour is to use the mapping name as mapping_id for matching.
  3. When the server does not have a Plex Pass then the Edition Field is not accessible. In this scenario, PMM will check the movie's filepath for {edition-...} to determine what the edition is.

Examples

Below are some examples on how movies can be matched.

Example 1 - title and mapping_id

The below example shows how title and mapping_id can be used to match movies.

metadata:
  movie1:                   # Matches via the title "Star Wars"
    match:
      title: Star Wars
    edits...
  movie2:                   # Matches via TMDb ID: 299534
    match:
      mapping_id: 299534
    edits...
  movie3:                   # Matches via IMDb ID: tt4154756
    match:
      mapping_id: tt4154756
    edits...
  movie4:                   # Matches via the title "9" 
    match:
      title: 9
    edits...

The Mapping Name can also be used to reduce line-count, as shown here:

metadata:
  Star Wars:    # Matches via the title "Star Wars"
    edits...
  299534:       # Matches via TMDb ID: 299534
    edits...
  tt4154756:    # Matches via IMDb ID: tt4154756
    edits...
  "9":          # Matches via the title "9" 
    edits...

Note: to search for a movie titled with a number from the mapping name you must surround the number in quotes like in the example below. Otherwise, it will look for the movie associated with that TMDb ID.

Example 2 - title and year

The below example shows how title and year can be used to match movies.

In this example, there are two movies in the library called "Godzilla", so the year attribute is used to identify which movie is being matched.

metadata:
  Godzilla (1954):                   # Matches via the title "Godzilla" released in 1954
    match:
      title: Godzilla
      year: 1954
    edits...
  Godzilla (1998):                   # Matches via the title "Godzilla" released in 1998
    match:
      title: Godzilla
      year: 1998
    edits...

Example 3 - using editions

The edition attributes can be used to further specify which version of a movie should be matched within Plex.

This can be combined with Example 1 as follows

metadata:
  movie1:                   # Matches via the title "Star Wars" and edition containing "4K77"
    match:
      title: Star Wars
      edition_contains: 4K77
    edits...

If you wanted to specify the version of Star Wars which does not have an edition, then the blank_edition attribute can be used as shown below:

metadata:
  movie1:                   # Matches via the title "Star Wars" and checks for no edition version
    match:
      title: Star Wars
      blank_edition: true
    edits...

Metadata Edits

The available attributes for editing movies are as follows

Special Attributes

Attribute Description
tmdb_show TMDb Show ID to use for metadata. Used when the Movie in your library is actually a miniseries on TMDb. (Example: Halo 4: Forward Unto Dawn or IT) This is not used to say this movie is the given ID.
run_definition Used to specify if this definition runs.
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.
Values: movie, show, artist, true, false
  1. If the server does not have a Plex Pass then the Edition Field is not accessible. In this case PMM will check the movies filepath for {edition-MOVIES EDITION} to determine what the edition is.

General Attributes

Attribute Allowed Values
title Text to change Title.
sort_title Text to change Sort Title.
edition1 Text to change Edition.
original_title Text to change Original Title.
originally_available Date to change Originally Available.
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.
  1. Requires Plex Pass

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 Allowed Values
director List or comma-separated text of each Director Tag.
country List or comma-separated text of each Country Tag.
genre List or comma-separated text of each Genre Tag.
writer List or comma-separated text of each Writer Tag.
producer List or comma-separated text of each Producer Tag.
collection List or comma-separated text of each Collection Tag.
label List or comma-separated text of each Label Tag.

Image Attributes

Attribute Allowed Values
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

Attribute Allowed Values
metadata_language1 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_title1 default: Library default
no: No
yes: Yes
  1. Must be using the New Plex Movie Agent.