diff --git a/docs/config/settings.md b/docs/config/settings.md index 23c9f8f9..12fa94cd 100644 --- a/docs/config/settings.md +++ b/docs/config/settings.md @@ -87,7 +87,7 @@ Set the number of days before each cache mapping expires and has to be re-cached ## Image Asset Directory -Specify the directory where assets are located. +Specify the directory where assets (posters, backgrounds, etc) are located. @@ -118,10 +118,12 @@ i.e. `assets/Star Wars/poster.png` instead of `assets/Star Wars.png` ## 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 `(filename).ext` or a dedicated folder containing `poster.ext` +i.e. `assets/Star Wars/poster.png` and `assets/Star Wars.png` are both asset depth 0 +and `assets/Movies/Star Wars/poster.png` and `assets/Movies/Star Wars.png` are both asset level 1 * `asset_folders` must be set to `true` for this to take effect. * increasing the amount of levels to scan will reduce performance -
@@ -135,6 +137,7 @@ Specify how many folder levels to scan for an item within the asset directory
@@ -241,6 +244,8 @@ Whilst searching for assets, show or hide the `update not needed` messages. ## Sync Mode Set the default `sync_mode` for collections. +* `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
@@ -256,6 +261,7 @@ Set the default `sync_mode` for collections. ## Default Collection Order Set the default `collection_order` for every collection run by PMM. +* `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)
@@ -275,7 +281,7 @@ Set the default `collection_order` for every collection run by PMM. 1 `plex_search` sort options can be found [here](../metadata/builders/plex.md#sort-options) ## Minimum Items -Set the minimum number of items that must be found in order to update a collection/playlist. +Set the minimum number of items that must be found in order to build or update a collection/playlist.
@@ -291,6 +297,7 @@ Set the minimum number of items that must be found in order to update a collecti ## Delete Below Minimum When a collection is run, delete the collection if it is below the minimum number specified by `minimum_items`. * Relies on `minimum_items` being set to the desired integer. +
@@ -320,6 +327,7 @@ If a collection is skipped due to it not being scheduled, delete the collection. ## 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. * A collection is a `run_again` collection if it has the `run_again` [Setting Detail](../metadata/details/definition) attribute set to true.
Default Value
@@ -380,6 +388,7 @@ List all items which have been filtered out of a collection (i.e. if it doesn't ## 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.
@@ -474,6 +483,7 @@ Specify the language to query TVDb in. ## Ignore IDs Set a list or comma-separated string of TMDb/TVDb IDs to ignore in all collections. +* this does not apply to `smart_filter` Collections
@@ -488,6 +498,7 @@ Set a list or comma-separated string of TMDb/TVDb IDs to ignore in all collectio ## Ignore IMDb IDs Set a list or comma-separated string of IMDb IDs to ignore in all collections. +* this does not apply to `smart_filter` Collections
@@ -517,7 +528,7 @@ Specify the amount of time to wait between each `item_refresh` of every movie/sh ## Playlist Sync to Users Set the default playlist `sync_to_users`. To Sync a playlist to only yourself leave `playlist_sync_to_users` blank. - +* sharing playlists with other users will not share any posters associated with the playlist, this is a Plex limitation.
@@ -560,7 +571,7 @@ Specify where the `repo` attribute's base is when defining `metadata_paths` and ## Verify SSL Turn SSL Verification on or off. - +* set to false if your log file shows any errors similar to "SSL: CERTIFICATE_VERIFY_FAILED"
Default Value
@@ -575,11 +586,13 @@ Turn SSL Verification on or off. ## Check Nightly Will check nightly for updates instead of develop. +* 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
- +
Default Valuetruefalse
Allowed Values