??? blank "`assets_for_all` - Used to search the asset directories for images for all items in the library.<aclass="headerlink"href="#assets-for-all"title="Permanent link">¶</a>"
??? blank "`delete_collections` - Deletes collections based on a set of given attribute.<aclass="headerlink"href="#delete-collections"title="Permanent link">¶</a>"
**Accepted Values:** There are a few different options to determine how the `delete_collections` works.
<tableclass="clearTable">
<tr><td>`managed: true`</td><td>Collection must be Managed to be deleted<br>(collection has the `PMM` label)</td></tr>
<tr><td>`managed: false`</td><td>Collection must be Unmanaged to be deleted<br>(collection does not have the `PMM` label)</td></tr>
<tr><td>`configured: true`</td><td>Collection must be Configured to be deleted<br>(collection is in the config file of the specific PMM run)</td></tr>
<tr><td>`configured: false`</td><td>Collection must be Unconfigured to be deleted<br>(collection is not in the config file of the specific PMM run)</td></tr>
<tr><td>`less: ###`</td><td>Collection must contain less than the given number of items to be deleted.<br>### is a Number greater than 0<br>Optional value which if undefined means collections will be deleted regardless of how many items they have</td></tr>
Removes all Managed Collections (Collections with the `PMM` Label) that are not configured in the Current Run.
```yaml
libraries:
Movies:
operations:
delete_collections:
configured: false
managed: true
```
??? blank "`mass_genre_update` - Updates the genres of every item in the library.<aclass="headerlink"href="#mass-genre-update"title="Permanent link">¶</a>"
<divid="mass-genre-update"/>Updates every item's genres in the library to the chosen site's genres.
<hrstyle="margin: 0px;">
**Attribute:**`mass_genre_update`
**Accepted Values:**
<tableclass="clearTable">
<tr><td>`tmdb`</td><td>Use TMDb for Genres</td></tr>
<tr><td>`tvdb`</td><td>Use TVDb for Genres</td></tr>
<tr><td>`imdb`</td><td>Use IMDb for Genres</td></tr>
<tr><td>`omdb`</td><td>Use IMDb through OMDb for Genres</td></tr>
<tr><td>`anidb`</td><td>Use AniDB Main Tags for Genres</td></tr>
<tr><td>`anidb_3_0`</td><td>Use AniDB Main Tags and All 3 Star Tags and above for Genres</td></tr>
<tr><td>`anidb_2_5`</td><td>Use AniDB Main Tags and All 2.5 Star Tags and above for Genres</td></tr>
<tr><td>`anidb_2_0`</td><td>Use AniDB Main Tags and All 2 Star Tags and above for Genres</td></tr>
<tr><td>`anidb_1_5`</td><td>Use AniDB Main Tags and All 1.5 Star Tags and above for Genres</td></tr>
<tr><td>`anidb_1_0`</td><td>Use AniDB Main Tags and All 1 Star Tags and above for Genres</td></tr>
<tr><td>`anidb_0_5`</td><td>Use AniDB Main Tags and All 0.5 Star Tags and above for Genres</td></tr>
<tr><td>`mal`</td><td>Use MyAnimeList for Genres</td></tr>
<tr><td>`lock`</td><td>Lock all Genre Field</td></tr>
<tr><td>`unlock`</td><td>Unlock all Genre Field</td></tr>
<tr><td>`remove`</td><td>Remove all Genres and Lock all Field</td></tr>
<tr><td>`reset`</td><td>Remove all Genres and Unlock all Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
Movies:
operations:
mass_genre_update: imdb
```
??? blank "`mass_content_rating_update` - Updates the content rating of every item in the library.<aclass="headerlink"href="#mass-content-rating-update"title="Permanent link">¶</a>"
<divid="mass-content-rating-update"/>Updates every item's content rating in the library to the chosen site's
content rating.
<hrstyle="margin: 0px;">
**Attribute:**`mass_content_rating_update`
**Accepted Values:**
<tableclass="clearTable">
<tr><td>`mdb`</td><td>Use MdbList for Content Ratings</td></tr>
<tr><td>`mdb_commonsense`</td><td>Use Commonsense Rating through MDbList for Content Ratings</td></tr>
<tr><td>`mdb_commonsense0`</td><td>Use Commonsense Rating with Zero Padding through MDbList for Content Ratings</td></tr>
<tr><td>`omdb`</td><td>Use IMDb through OMDb for Content Ratings</td></tr>
<tr><td>`mal`</td><td>Use MyAnimeList for Content Ratings</td></tr>
<tr><td>`remove`</td><td>Remove Content Rating and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Content Rating and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
Movies:
operations:
mass_content_rating_update: omdb
```
??? blank "`mass_original_title_update` - Updates the original title of every item in the library.<aclass="headerlink"href="#mass-original-title-update"title="Permanent link">¶</a>"
<divid="mass-original-title-update"/>Updates every item's original title in the library to the chosen site's
original title.
<hrstyle="margin: 0px;">
**Attribute:**`mass_original_title_update`
**Accepted Values:**
<tableclass="clearTable">
<tr><td>`anidb`</td><td>Use AniDB Main Title for Original Titles</td></tr>
<tr><td>`anidb_official`</td><td>Use AniDB Official Title based on the language attribute in the config file for Original Titles</td></tr>
<tr><td>`mal`</td><td>Use MyAnimeList Main Title for Original Titles</td></tr>
<tr><td>`mal_english`</td><td>Use MyAnimeList English Title for Original Titles</td></tr>
<tr><td>`mal_japanese`</td><td>Use MyAnimeList Japanese Title for Original Titles</td></tr>
<tr><td>`lock`</td><td>Lock Original Title Field</td></tr>
<tr><td>`unlock`</td><td>Unlock Original Title Field</td></tr>
<tr><td>`remove`</td><td>Remove Original Title and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Original Title and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
Anime:
operations:
mass_original_title_update: anidb_official
```
??? blank "`mass_studio_update` - Updates the studio of every item in the library.<aclass="headerlink"href="#mass-studio-update"title="Permanent link">¶</a>"
<divid="mass-studio-update"/>Updates every item's studio in the library to the chosen site's studio.
<hrstyle="margin: 0px;">
**Attribute:**`mass_studio_update`
**Accepted Values:**
<tableclass="clearTable">
<tr><td>`anidb`</td><td>Use AniDB Animation Work for Studio</td></tr>
<tr><td>`mal`</td><td>Use MyAnimeList Studio for Studio</td></tr>
<tr><td>`tmdb`</td><td>Use TMDb Studio for Studio</td></tr>
<tr><td>`lock`</td><td>Lock Original Title Field</td></tr>
<tr><td>`unlock`</td><td>Unlock Original Title Field</td></tr>
<tr><td>`remove`</td><td>Remove Original Title and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Original Title and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
Anime:
operations:
mass_studio_update: mal
```
??? blank "`mass_originally_available_update` - Updates the originally available date of every item in the library.<aclass="headerlink"href="#mass-originally-available-update"title="Permanent link">¶</a>"
<divid="mass-originally-available-update"/>Updates every item's originally available date in the library to the
chosen site's date.
???+ tip
As plex does not allow this field to be empty, using `remove` or `reset` will set the date to the Plex default
<tr><td>`lock`</td><td>Lock Originally Available Field</td></tr>
<tr><td>`unlock`</td><td>Unlock Originally Available Field</td></tr>
<tr><td>`remove`</td><td>Remove Originally Available and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Originally Available and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
TV Shows:
operations:
mass_originally_available_update: tvdb
```
??? blank "`mass_***_rating_update` - Updates the audience/critic/user rating of every item in the library.<aclass="headerlink"href="#mass-star-rating-update"title="Permanent link">¶</a>"
<divid="mass-star-rating-update"/>Updates every item's audience/critic/user rating in the library to the chosen
site's rating.
???+ warning "Important Note"
This does not affect the icons displayed in the Plex UI. This will place the number of your choice in the
relevant field in the Plex database. In other words, if Plex is configured to use Rotten Tomatoes ratings, then
no matter what happens with this mass rating update operation, the icons in the Plex UI will remain Rotten
Tomatoes. The human who decided to put TMDb ratings in the critic slot and Letterboxd ratings in the audience
slot is the only party who knows that the ratings are no longer Rotten Tomatoes. One primary use of this feature
is to put ratings overlays on posters. More information on what PMM can do with these ratings can be found
<tr><td>`remove`</td><td>Remove Rating and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Rating and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
Movies:
operations:
mass_audience_rating_update: mdb_average
mass_critic_rating_update: mdb_metacritic
mass_user_rating_update: imdb
```
??? blank "`mass_episode_***_rating_update` - Updates the audience/critic/user rating of every episode in the library.<aclass="headerlink"href="#mass-episode-star-rating-update"title="Permanent link">¶</a>"
<divid="mass-episode-star-rating-update"/>Updates every item's episode's audience/critic/user rating in the
library to the chosen site's rating.
???+ warning "Important Note"
This does not affect the icons displayed in the Plex UI. This will place the number of your choice in the
relevant field in the Plex database. In other words, if Plex is configured to use Rotten Tomatoes ratings, then
no matter what happens with this mass rating update operation, the icons in the Plex UI will remain Rotten
Tomatoes. The human who decided to put TMDb ratings in the critic slot and Letterboxd ratings in the audience
slot is the only party who knows that the ratings are no longer Rotten Tomatoes. One primary use of this feature
is to put ratings overlays on posters. More information on what PMM can do with these ratings can be found
<tr><td>`remove`</td><td>Remove Rating and Lock Field</td></tr>
<tr><td>`reset`</td><td>Remove Rating and Unlock Field</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
TV Shows:
operations:
mass_episode_audience_rating_update: tmdb
mass_episode_critic_rating_update: remove
mass_episode_user_rating_update: imdb
```
??? blank "`mass_poster_update` - Updates the poster of every item in the library.<aclass="headerlink"href="#mass-poster-update"title="Permanent link">¶</a>"
<divid="mas-_poster-update"/>Updates every item's poster to the chosen sites poster. Will fall back to `plex` if
the given option fails. Assets will be used over anything else.
???+ warning
When used in combination with Overlays, this could cause PMM to reset the poster and then reapply all overlays
on each run, which will result in [image bloat](../pmm/scripts/image-cleanup.md).
<tr><td>`source`</td><td>Source of the poster update</td><td>`tmdb`, `plex`, `lock`, or `unlock`</td></tr>
<tr><td>`seasons`</td><td>Update season posters while updating shows **Default:**`true`</td><td>`true` (default) or `false`</td></tr>
<tr><td>`episodes`</td><td>Update episode posters while updating shows **Default:**`true`</td><td>`true` (default) or `false`</td></tr>
</table>
???+ example "Example"
```yaml
libraries:
TV Shows:
operations:
mass_poster_update:
source: tmdb
seasons: false
episodes: false
```
??? blank "`mass_background_update` - Updates the background of every item in the library.<aclass="headerlink"href="#mass-background-update"title="Permanent link">¶</a>"
<divid="mass-background-update"/>Updates every item's background to the chosen sites background. Will fall back to
`plex` if the given option fails. Assets will be used over anything else.
???+ warning
When used in combination with Overlays, this could cause PMM to reset the background and then reapply all
overlays on each run, which will result in [image bloat](../pmm/scripts/image-cleanup.md).
??? blank "`mass_imdb_parental_labels` - Adds IMDb Parental labels of every item in the library.<aclass="headerlink"href="#mass-imdb-parental-labels"title="Permanent link">¶</a>"
??? blank "`mass_collection_mode` - Updates the Collection Mode of every item in the library.<aclass="headerlink"href="#mass-collection-mode"title="Permanent link">¶</a>"
??? blank "`update_blank_track_titles` - Updates blank track titles of every item in the library.<aclass="headerlink"href="#update-blank-track-titles"title="Permanent link">¶</a>"
??? blank "`remove_title_parentheses` - Removes title parentheses of every item in the library.<aclass="headerlink"href="#remove-title-parentheses"title="Permanent link">¶</a>"
??? blank "`split_duplicates` - Splits all duplicate items found in this library.<aclass="headerlink"href="#split-duplicates"title="Permanent link">¶</a>"
??? blank "`radarr_remove_by_tag` - Removes every item from Radarr with the Tags given.<aclass="headerlink"href="#radarr-remove-by-tag"title="Permanent link">¶</a>"
??? blank "`sonarr_remove_by_tag` - Removes every item from Sonarr with the Tags given.<aclass="headerlink"href="#sonarr-remove-by-tag"title="Permanent link">¶</a>"
??? blank "`genre_mapper` - Maps genres in your library to be changed to other genres.<aclass="headerlink"href="#genre-mapper"title="Permanent link">¶</a>"
??? blank "`content_rating_mapper` - Maps content ratings in your library to be changed to other content ratings.<aclass="headerlink"href="#content-rating-mapper"title="Permanent link">¶</a>"
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`.
```yaml
libraries:
Movies:
# Metadata and Overlay files here
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.
```yaml
libraries:
Movies:
# Metadata and Overlay files here
operations:
content_rating_mapper:
PG: Y-10
"PG-13": Y-10
R:
```
The above 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`.
??? blank "`metadata_backup` - Creates/Maintains a PMM Metadata File for the library.<aclass="headerlink"href="#metadata-backup"title="Permanent link">¶</a>"
<divid="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.
<hrstyle="margin: 0px;">
**Attribute:**`metadata_backup`
**Accepted Values:** There are a few different options to determine how the `metadata_backup` works.
<tableclass="clearTable">
<tr><td>`path`</td><td>Path to where the metadata will be saved/maintained<br>**Default:** `<<library_name>>_Metadata_Backup.yml in your config folder`<br>**Values:** Path to Metadata File</td></tr>
<tr><td>`exclude`</td><td>Exclude all listed attributes from being saved in the collection file<br>**Values:** `Comma-separated string or list of attributes`</td></tr>
<tr><td>`sync_tags`</td><td>All Tag Attributes will have the `.sync` option and blank attribute will be added to sync<br>**Default:** `false`<br>**Values:** `true` or `false`</td></tr>
<tr><td>`add_blank_entries`</td><td>Will add a line for entries that have no metadata changes<br>**Default:** `true`<br>**Values:** `true` or `false`</td></tr>