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):
title: Godzilla
year: 1954
content_rating: R
Godzilla (1998):
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):
alt_title: Halloween
year: 2007
"Halo 4: Forward Unto Dawn":
alt_title: Halo 4 Forward Unto Dawn
tmdb_show: 56295
content_rating: R
Movies¶
Each metadata definition is defined by the mapping name which can link to a movie in multiple ways.
Mapping name must match the movie name in Plex exactly unless an
alt_title
is specified.Mapping name must match the TMDb ID or IMDb ID mapped to the movie.
Note: to search for a movie titled with a number surround the number in quotes like in the example below.
metadata:
Star Wars: # Matches via the Name "Star Wars"
edits...
299534: # Matches via TMDb ID: 299534
edits...
tt4154756: # Matches via IMDb ID: tt4154756
edits...
"9": # Matches via the Name "9"
edits...
Metadata Edits¶
The available attributes for editing movies are as follows
Special Attributes¶
Attribute |
Allowed Values |
---|---|
|
Title if different from the mapping value useful when you have multiple movies with the same name. See the Metadata Page for how searching for files works. |
|
Alternative title to look for and then change to the mapping name. See the Metadata Page for how searching for files works. |
|
Year of movie for better identification. See the Metadata Page for how searching for files works. |
|
Edition of movie for better identification. See the Metadata Page for how searching for files works. |
|
TMDb Show ID to use for metadata useful for miniseries that have been compiled into a movie. This is not used to say this show is the given ID. |
|
TMDb Movie ID to use for metadata useful for movies that have been split into segments This is not used to say this show is the given ID. |
General Attributes¶
Attribute |
Allowed Values |
---|---|
|
Text to change Sort Title |
|
Text to change Edition |
|
Text to change Original Title |
|
Date to change Originally Available |
|
Text to change Content Rating |
|
Number to change User Rating |
|
Number to change Audience Rating |
|
Number to change Critic Rating |
|
Text to change Studio |
|
Text to change Tagline |
|
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 |
Allowed Values |
---|---|
|
List or comma-separated text of each Director Tag |
|
List or comma-separated text of each Country Tag |
|
List or comma-separated text of each Genre Tag |
|
List or comma-separated text of each Writer Tag |
|
List or comma-separated text of each Producer Tag |
|
List or comma-separated text of each Collection Tag |
|
List or comma-separated text of each Label Tag |
Advanced Attributes¶
Attribute |
Allowed Values |
---|---|
|
|
|
|
* Must be using the *New Plex Movie Agent
Image Attributes¶
Attribute |
Description |
Allowed Values |
---|---|---|
|
Used to change the movie’s poster to the URL |
URL of image publicly available on the internet |
|
Used to change the movie’s poster to the image in the file system |
Path to image in the file system |
|
Use to change the movie’s background to the URL |
URL of image publicly available on the internet |
|
Used to change the movie’s background to the image in the file system |
Path to image in the file system |