Plex-Meta-Manager/docs/config/operations.md

Operations

There are a variety of Library Operations that can be utilized in a library.

Within each library, operations can be defined by using the operations attribute, as demonstrated below.

libraries:
  Movies:
    metadata_path:
      - pmm: imdb
    operations:
      mass_critic_rating_update: tmdb
      split_duplicates: true

The available attributes for the operations attribute are as follows

Attribute	Description
assets_for_all	Search in assets for images for every item in your library. Values: true or false
delete_collections_with_less	Deletes every collection with less than the given number of items. Values: number greater than 0
delete_unmanaged_collections	Deletes every unmanaged collection Values: true or false
mass_genre_update	Updates every item's genres in the library to the chosen site's genres Values: tmdb Use TMDb for Genres tvdb Use TVDb for Genres imdb Use IMDb for Genres omdb Use IMDb through OMDb for Genres anidb Use AniDB Tags for Genres mal Use MyAnimeList for Genres lock Lock Genre Field unlock Unlock Genre Field remove Remove all Genres and Lock Field reset Remove all Genres and Unlock Field
mass_content_rating_update	Updates every item's content rating in the library to the chosen site's content rating Values: mdb Use MdbList for Content Ratings mdb_commonsense Use Commonsense Rating through MDbList for Content Ratings mdb_commonsense0 Use Commonsense Rating with Zero Padding through MDbList for Content Ratings omdb Use IMDb through OMDb for Content Ratings mal Use MyAnimeList for Content Ratings lock Lock Content Rating Field unlock Unlock Content Rating Field remove Remove Content Rating and Lock Field reset Remove Content Rating and Unlock Field
mass_original_title_update	Updates every item's original title in the library to the chosen site's content rating Values: anidb Use AniDB Main Title for Original Titles anidb_official Use AniDB Official Title based on the language attribute in the config file for Original Titles mal Use MyAnimeList Main Title for Original Titles mal_english Use MyAnimeList English Title for Original Titles mal_japanese Use MyAnimeList Japanese Title for Original Titles lock Lock Original Title Field unlock Unlock Original Title Field remove Remove Original Title and Lock Field reset Remove Original Title and Unlock Field
mass_originally_available_update	Updates every item's originally available date in the library to the chosen site's date Values: tmdb Use TMDb Release Date tvdb Use TVDb Release Date omdb Use IMDb Release Date through OMDb mdb Use MdbList Release Date anidb Use AniDB Release Date mal Use MyAnimeList Release Date lock Lock Originally Available Field unlock Unlock Originally Available Field remove Remove Originally Available and Lock Field reset Remove Originally Available and Unlock Field
mass_audience_rating_update/ mass_critic_rating_update/ mass_user_rating_update	Updates every item's audience/critic/user rating in the library to the chosen site's rating Values: tmdb Use TMDb Rating imdb Use IMDb Rating trakt_user Use Trakt User's Personal Rating omdb Use IMDbRating through OMDb mdb Use MdbList Score mdb_imdb Use IMDb Rating through MDbList mdb_metacritic Use Metacritic Rating through MDbList mdb_metacriticuser Use Metacritic User Rating through MDbList mdb_trakt Use Trakt Rating through MDbList mdb_tomatoes Use Rotten Tomatoes Rating through MDbList mdb_tomatoesaudience Use Rotten Tomatoes Audience Rating through MDbList mdb_tmdb Use TMDb Rating through MDbList mdb_letterboxd Use Letterboxd Rating through MDbList mdb_myanimelist Use MyAnimeList Rating through MDbList anidb_rating Use AniDB Rating anidb_average Use AniDB Average anidb_score Use AniDB Review Score mal Use MyAnimeList Score lock Lock Rating Field unlock Unlock Rating Field remove Remove Rating and Lock Field reset Remove Rating and Unlock Field
mass_episode_audience_rating_update/ mass_episode_critic_rating_update/ mass_episode_user_rating_update	Updates every item's episode's audience/critic/user rating in the library to the chosen site's rating Values: tmdb Use TMDb Rating imdb Use IMDb Rating lock Lock Rating Field unlock Unlock Rating Field remove Remove Rating and Lock Field reset Remove Rating and Unlock Field
mass_imdb_parental_labels	Updates every item's labels in the library to match the IMDb Parental Guide Values with_none or without_none
mass_collection_mode	Updates every Collection in your library to the specified Collection Mode Values: default: Library default hide: Hide Collection hide_items: Hide Items in this Collection show_items: Show this Collection and its Items default Library default hide Hide Collection hide_items Hide Items in this Collection show_items Show this Collection and its Items
update_blank_track_titles	Search though every track in a music library and replace any blank track titles with the tracks sort title Values: true or false
remove_title_parentheses	Search through every title and remove all ending parentheses in an items title if the title isn not locked. Values: true or false
split_duplicates	Splits all duplicate movies/shows found in this library Values: true or false
radarr_add_all	Adds every item in the library to Radarr. The existing paths in plex will be used as the root folder of each item, if the paths in Plex are not the same as your Radarr paths you can use the plex_path and radarr_path Radarr details to convert the paths. Values: true or false
radarr_remove_by_tag	Removes every item from Radarr with the Tags given Values: List or comma separated string of tags
sonarr_add_all	Adds every item in the library to Sonarr. The existing paths in plex will be used as the root folder of each item, if the paths in Plex are not the same as your Sonarr paths you can use the plex_path and sonarr_path Sonarr details to convert the paths. Values: true or false
sonarr_remove_by_tag	Removes every item from Sonarr with the Tags given Values: List or comma separated string of tags
genre_mapper	Allows genres to be changed to other genres or be removed from every item in your library. Values: see below for usage
content_rating_mapper	Allows content ratings to be changed to other content ratings or be removed from every item in your library. Values: see below for usage
metadata_backup	Creates/Maintains a PMM Metadata File with a full metadata mapping based on the library's items locked attributes. Values: see below for usage

Genre Mapper

You can use the genre_mapper operation to map genres in your library.

Each attribute under genre_mapper is a separate mapping and has two parts.

• The key (Action/Adventure, Action & Adventure in the example below) is what genres you want mapped to the value.
• The value (Action in the example below) is what the genres will end up as.

So this example will change go through every item in your library and change the genre Action/Adventure or Action & Adventure to Action and Romantic Comedy to Comedy.

library:
  Movies:
    operations:
      genre_mapper:
        "Action/Adventure": Action 
        "Action & Adventure": Action
        Romantic Comedy: Comedy

To just Remove a Genre without replacing it just set the Genre to nothing like this.

library:
  Movies:
    operations:
      genre_mapper:
        "Action/Adventure": Action 
        "Action & Adventure": Action
        Romantic Comedy:

This example will change go through every item in your library and change the genre Action/Adventure or Action & Adventure to Action and remove every instance of the Genre Romantic Comedy.

Content Rating Mapper

You can use the content_rating_mapper operation to map content ratings in your library.

Each attribute under content_rating_mapper is a separate mapping and has two parts.

• The key (PG, PG-13 in the example below) is what content ratings you want mapped to the value.
• The value (Y-10 in the example below) is what the content ratings will end up as.

So this example will change go through every item in your library and change the content rating PG or PG-13 to Y-10 and R to Y-17.

library:
  Movies:
    operations:
      content_rating_mapper:
        PG: Y-10 
        "PG-13": Y-10
        R: Y-17

To just Remove a content rating without replacing it just set the content rating to nothing like this.

library:
  Movies:
    operations:
      content_rating_mapper:
        PG: Y-10 
        "PG-13": Y-10
        R:

This example will change go through every item in your library and change the content rating PG or PG-13 to Y-10 and remove every instance of the content rating R.

Metadata Backup

Creates/Maintains a Plex Meta Manager Metadata File with a full metadata mapping based on the library's items locked attributes.

If you point to an existing Metadata File then PMM will Sync the changes to the file, so you won't lose non plex changes in the file.

There are a few different options to determine how the metadata_backup works.

Attribute	Description
path	Path to where the metadata will be saved/maintained Default: <<library_name>>_Metadata_Backup.yml in your config folder Values: Path to Metadata File
exclude	Exclude all listed attributes from being saved in the metadata file Values: Comma-separated string or list of attributes
sync_tags	All Tag Attributes will have the .sync option and blank attribute will be added to sync to as well Default: false Values: true or false
add_blank_entries	Will add a line for entries that have no metadata changes Default: true Values: true or false