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.
Plex-Meta-Manager/docs/config/settings.md

24 KiB

search
boost
5

Settings

Overview

The settings: attribute and subsequent settings can be used to command various aspects of the functionality of Plex Meta Manager.

Examples of these settings include the ability to:

  • Cache each Plex GUID and IDs to increase performance
  • Create asset folders for collections so that custom posters can be stored for upload.
  • Use a custom repository as the base for all git Metadata files.

The settings attribute and attributes can be specified individually per library, or can be inherited from the global value if it has been set. If an attribute is specified at both the library and global level, then the library level attribute will take priority.

There are some attributes which can be specified at the collection level using Setting Details.

Attributes set at the collection level will take priority over any library or global-level attribute.

Attributes

The available setting attributes which can be set at each level are outlined below:

Attribute Global Level Library Level Collection/Playlist Level
cache :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
cache_expiration :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
asset_directory :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
asset_folders :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
asset_depth :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
create_asset_folders :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
prioritize_assets :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
dimensional_asset_rename :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
download_url_assets :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
show_missing_season_assets :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
show_missing_episode_assets :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
show_asset_not_needed :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
sync_mode :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
default_collection_order :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
minimum_items :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
delete_below_minimum :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
delete_not_scheduled :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
run_again_delay :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
missing_only_released :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
show_unmanaged :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
show_unconfigured :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red }
show_filtered :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
show_options :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
show_missing :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
only_filter_missing :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
show_missing_assets :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
save_report :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
tvdb_language :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
ignore_ids :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
ignore_imdb_ids :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
item_refresh_delay :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-check:{ .green }
playlist_sync_to_users :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-check:{ .green }
playlist_exclude_users :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-check:{ .green }
playlist_report :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .green } :fontawesome-solid-circle-xmark:{ .red }
run_order :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .green } :fontawesome-solid-circle-xmark:{ .red }
custom_repo :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
verify_ssl :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }
check_nightly :fontawesome-solid-circle-check:{ .green } :fontawesome-solid-circle-xmark:{ .red } :fontawesome-solid-circle-xmark:{ .red }

Default Values

The below in an extract of the config.yml.template and is the initial values that are set if you follow any of the installation guides.

???+ tip

We suggest users review each of these settings and amend as necessary, these are just default values to get you started.
{%    
  include-markdown "./config.yml.template" 
  comments=false
  start="settings:"
  end="webhooks:"
%}

Example Library-Level Settings

The below showcases how to set a library-level setting, assuming that the attribute is listed as a library-level compatible attribute in the above table.

If no library-level attribute is set, then the global attribute is used.

???+ tip

Press the :fontawesome-solid-circle-plus: icon to learn more
libraries:
  Movies:
    run_order: #(1)!
    - metadata
    - operations
    - overlays
    minimum_items: 3 #(2)!
    metadata_path:
      # stuff here
    overlay_path:
      # stuff here
    operations:
      # stuff here
  TV Shows:
    metadata_path:
      # stuff here
    overlay_path:
      # stuff here
    operations:
      # stuff here
settings:
  run_order: #(3)!
  - operations
  - metadata
  - overlays
  minimum_items: 1 #(4)!
  1. Sets the run_order specifically for the Movies library
  2. Sets the minimum_items attribute specifically for the Movies library
  3. Sets the global run_order which will apply to all libraries unless a library-level run_order is found, as showcased in the above example
  4. Sets the global minimum_items which will apply to all libraries unless a library-level minimum_items is found, as showcased in the above example

Cache

Cache the Plex GUID and associated IDs for each library item for faster subsequent processing. The cache file is created in the same directory as the configuration file.

Default Value true
Allowed Values true or false

Cache Expiration

Set the number of days before each cache mapping expires and has to be re-cached.

Default Value 60
Allowed Values any integer

Image Asset Directory

Specify the directory where assets (posters, backgrounds, etc) are located.

???+ important

Assets can be stored anywhere on the host system that PMM has visibility of (i.e. if using docker, the directory must be mounted/visible to the docker container).
Default Value [Directory containing YAML config]/assets
Allowed Values any directory

Image Asset Folders

Search the asset_directory for a dedicated folder. Set to true if each poster is within its own directory.
i.e. <path_to_assets>/Star Wars/poster.png instead of <path_to_assets>/Star Wars.png

Default Value true
Allowed Values true or false

Asset Depth

Specify how many folder levels to scan for an item within the asset directory

At each asset level, PMM will look for either medianame.ext [such as Star Wars.png] or a dedicated folder containing poster.ext

i.e. <path_to_assets>/Star Wars/poster.png and <path_to_assets>/Star Wars.png are both asset depth 0, whilst <path_to_assets>/Movies/Star Wars/poster.png and <path_to_assets>/Movies/Star Wars.png are both asset level 1

???+ note

`asset_folders` must be set to `true` for this to take effect.

increasing the amount of levels to scan will reduce performance
Default Value 0
Allowed Values any integer

Create Asset Folders

Whilst searching for assets, if an asset folder cannot be found within the asset_directory one will be created.

Asset Searches can happen in a number of ways.

  • Any Collection specified under the collections header in a Metadata File.
  • Any Item specified under the metadata header in a Metadata File.
  • Any Playlist specified under the playlists header in a Playlist File.
  • Any Item in a library that is running the assets_for_all Library Operation.
  • Any Item that has an Overlay applied to it.
  • Any Item found by a Builder while the definition also has item_assets: true specified.
Default Value false
Allowed Values true or false

Prioritize Assets

When determining which image to use on an item prioritize the asset_directory over all other images types.

Default Value false
Allowed Values true or false

Dimensional Asset Rename

Whilst searching for assets, scan the folders within the asset_directory and if an asset poster (i.e. /ASSET_NAME/poster.ext) was not found, rename the first image found that has a height greater than or equal to its width to poster.ext. If an asset background (i.e. /ASSET_NAME/background.ext), rename the first image found that has a width greater than its height to background.ext.

???+ note

`asset_folders` must be set to `true` for this to take effect.
Default Value false
Allowed Values true or false

Download URL Assets

Whilst searching for assets, download images set within Metadata/Playlist files( i.e. images set by url_poster or url_background) into the asset folder if none are already present.

Default Value false
Allowed Values true or false

Show Missing Season Assets

Whilst searching for assets, when scanning for assets for a TV Show, if Season posters are found (i.e. /ASSET_NAME/Season##.ext), notify the user of any seasons which do not have an asset image.

Default Value false
Allowed Values true or false

Show Missing Episode Assets

Whilst searching for assets, when scanning for assets for a TV Show, if an Episode Title Card is found (i.e. /ASSET_NAME/S##E##.ext), notify the user of any episodes which do not have an asset image.

Default Value false
Allowed Values true or false

Show Asset Not Needed

Whilst searching for assets, show or hide the update not needed messages.

Default Value false
Allowed Values true or false

Sync Mode

Set the default sync_mode for collections.

???+ note

`sync` will add and remove any items that are added/removed from the source builder
`append` will only add items that are added from the source builder, but will not remove anything even if it is removed from the source builder.
Default Value append
Allowed Values append or sync

Default Collection Order

Set the default collection_order for every collection run by PMM.

???+ note

`custom` cannot be used if more than one builder is being used for the collection (such as `imdb_list` and `trakt_list` within the same collection)
Default Value None
Allowed Values release: Order Collection by Release Dates
alpha: Order Collection Alphabetically
custom: Order Collection Via the Builder Order
Any plex_search sort option1

1 plex_search sort options can be found here

Minimum Items

Set the minimum number of items that must be found in order to build or update a collection/playlist.

Default Value 1
Allowed Values any integer

Delete Below Minimum

When a collection is run, delete the collection if it is below the minimum number specified by minimum_items.

???+ note

Relies on `minimum_items` being set to the desired integer.
Default Value false
Allowed Values true or false

Delete Not Scheduled

If a collection is skipped due to it not being scheduled, delete the collection.

Default Value false
Allowed Values true or false

Run Again Delay

Set the number of minutes to delay running run_again collections after daily run is finished.

For example, if a collection adds items to Sonarr/Radarr, the library can automatically re-run "X" amount of time later so that any downloaded items are processed.

???+ note

A collection is a `run_again` collection if it has the `run_again` [Setting Detail](../builders/details/definition.md) attribute set to true.
Default Value 1
Allowed Values any integer

Missing Only Released

Whilst running a collection, all unreleased missing items will be filtered out from the missing YAML file

Default Value false
Allowed Values true or false

Show Unmanaged Collections

List all collections not managed by Plex Meta Manager at the end of each run.

Default Value true
Allowed Values true or false

Show Filtered

List all items which have been filtered out of a collection (i.e. if it doesn't meet the filter criteria)

Default Value false
Allowed Values true or false

Show Options

While show_options is true the available options for an attribute when using plex_search, smart_filter or filters will be shown. i.e. a smart_filter on the genre attribute will return all of the attributes within the specified library.

Default Value false
Allowed Values true or false

Show Missing

While show_missing is true items missing from collections will be displayed.

Default Value true
Allowed Values true or false

Only Filter Missing

Only items missing from a collection will be filtered. Only specific filters can filter missing. See Filters for more information.

???+ note

this can be used to filter which missing media items get sent to Sonarr/Radarr
Default Value false
Allowed Values true or false

Show Missing Assets

Display missing asset warnings

Default Value true
Allowed Values true or false

Save Report

Save a report of the items added, removed, filtered, or missing from collections to a YAML file in the same directory as your Metadata file.

Default Value true
Allowed Values true or false

TVDb Language

Specify the language to query TVDb in.

???+ note

If no language is specified or the specified language is not found then the original language is used.
Default Value None
Allowed Values Any ISO 639-2 Language Code1

1 Language Codes can be found here

Ignore IDs

Set a list or comma-separated string of TMDb/TVDb IDs to ignore in all collections.

???+ note

this does not apply to `smart_filter` Collections
Default Value None
Allowed Values List or comma-separated string of TMDb/TVDb IDs

Ignore IMDb IDs

Set a list or comma-separated string of IMDb IDs to ignore in all collections.

???+ note

this does not apply to `smart_filter` Collections
Default Value None
Allowed Values List or comma-separated string of IMDb IDs

Item Refresh Delay

Specify the amount of time to wait between each item_refresh of every movie/show in a collection/playlist.

???+ note

Useful if your Plex Media Server is having issues with high request levels.
Default Value 0
Allowed Values any integer

Playlist Sync to Users

Set the default playlist sync_to_users. To Sync a playlist to only yourself leave playlist_sync_to_users blank.

???+ note

sharing playlists with other users will not share any posters associated with the playlist, this is a Plex limitation.
Default Value all
Allowed Values all, list of users, or comma-separated string of users

Playlist Exclude Users

Set the default playlist exclude_users.

Default Value
Allowed Values list of users or comma-separated string of users

Playlist Report

Set playlist_report to true to print out a playlist report at the end of the log.

Default Value false
Allowed Values true or false

Run Order

Specify the run order of the library components [Library Operations, Metadata Files and Overlay Files]

???+ tip

If not specified, the default run order is Library Operations, then Metadata Files, then Overlay Files

```yml
settings:
  run_order:
  - operations
  - metadata
  - overlays
```
Default Value ``
Allowed Values List which must include operations, metadata and overlays in any order

Custom Repo

Specify where the repo attribute's base is when defining metadata_path, playlist_file and overlay_path.

???+ note

Ensure you are using the raw GitHub link (i.e. https://github.com/meisnate12/Plex-Meta-Manager-Configs/tree/master/meisnate12 )
Default Value None
Allowed Values link to base repository

Verify SSL

Turn SSL Verification on or off.

???+ note

set to false if your log file shows any errors similar to "SSL: CERTIFICATE_VERIFY_FAILED"
Default Value true
Allowed Values true or false

Check Nightly

Will check nightly for updates instead of develop.

???+ note

This does not affect which version of PMM is grabbed when using `git pull` or any other update mechanism, it is only used for the initial version check when PMM runs to specify if a new version is available.

It is recommended to set this to `true` if you primarily use the `nightly` branch
Default Value false
Allowed Values true or false