Plex-Meta-Manager/docs/defaults/playlist.md
2023-11-06 15:38:00 -05:00

18 KiB

Playlists

The playlist Default Metadata File is used to create playlists based on popular Movie/TV Show universes (such as the Marvel Cinematic Universe or Star Trek).

This Default file requires Trakt Authentication

This file assumes that you have libraries named Movies and TV Shows. If you do not have these libraries or want to use alternative/additional libraries, use the libraries template variable which is outlined in the Template Variables table.

Playlists

Playlist Key Description
Arrowverse (Timeline Order) arrow Playlist of Movies and Episodes in the Arrowverse (Timeline Order)
DC Animated Universe (Timeline Order) dcau Playlist of Movies and Episodes in the DC Animated Universe (Timeline Order)
Dragon Ball (Timeline Order) dragonball Playlist of Movies and Episodes in the Dragon Ball (Timeline Order)
Marvel Cinematic Universe (Timeline Order) mcu Playlist of Movies and Episodes in the Marvel Cinematic Universe (Timeline Order)
Pokémon (Timeline Order) pokemon Playlist of Movies and Episodes in the Pokémon (Timeline Order)
Star Trek (Timeline Order) startrek Playlist of Movies and Episodes in the Star Trek (Timeline Order)
Star Wars (Timeline Order) starwars Playlist of Movies and Episodes in the Star Wars (Timeline Order)
Star Wars The Clone Wars (Timeline Order) clonewars Playlist of Movies and Episodes in the Star Wars The Clone Wars (Timeline Order)
X-Men (Timeline Order) xmen Playlist of Movies and Episodes in the X-Men (Timeline Order)

Config

The below YAML in your config.yml will create the collections:

playlist_files:
  - pmm: playlist

Template Variables

Template Variables can be used to manipulate the file in various ways to slightly change how it works without having to make your own local copy.

Note that the template_variables: section only needs to be used if you do want to actually change how the defaults work. Any value not specified is its default value if it has one if not it's just ignored.

Shared Variables are NOT available to this default file.

Variable Description & Values
use_<<key>>1 Description: Turns off individual Playlists in a Defaults file.
Values: false to turn off the playlist
name_<<key>>1 Description: Changes the name of the specified key's playlist.
Values: New Playlist Name
summary_<<key>>1 Description: Changes the summary of the specified key's playlist.
Values: New Playlist Summary
libraries Description: Sets the names of the libraries to use for the Playlists.
Default: Movies, TV Shows
Values: Comma-separated string or list of library mapping names defined in the libraries attribute in the base of your [Configuration File](../config/configuration.md.
sync_to_user Description: Sets the users to sync all playlists to.
Default: playlist_sync_to_users Global Setting Value
Values: Comma-separated string or list of user names.
sync_to_user_<<key>>1 Description: Sets the users to sync the specified key's playlist to.
Default: sync_to_user Value
Values: Comma-separated string or list of user names.
exclude_user Description: Sets the users to exclude from sync for all playlists.
Default: playlist_sync_to_users Global Setting Value
Values: Comma-separated string or list of user names.
exclude_user_<<key>>1 Description: Sets the users to exclude from sync the specified key's playlist.
Default: sync_to_user Value
Values: Comma-separated string or list of user names.
trakt_list_<<key>>1 Description: Adds the Movies in the Trakt List to the specified key's playlist. Overrides the default trakt_list for that playlist if used.
Values: List of Trakt List URLs
delete_playlist Description: Will delete all playlists for the users defined by sync_to_users.
Values: true or false
delete_playlist_<<key>>1 Description: Will delete the specified key's playlists for the users defined by sync_to_users.
Values: true or false
ignore_ids Description: Set a list or comma-separated string of TMDb/TVDb IDs to ignore in all playlists.
Values: List or comma-separated string of TMDb/TVDb IDs
ignore_imdb_ids Description: Set a list or comma-separated string of IMDb IDs to ignore in all playlists.
Values: List or comma-separated string of IMDb IDs
url_poster_<<key>>1 Description: Changes the poster url of the specified key's playlist.
Values: URL directly to the Image
radarr_add_missing Description: Override Radarr add_missing attribute for all playlists in a Defaults file.
Values: true or false
radarr_add_missing_<<key>>1 Description: Override Radarr add_missing attribute of the specified key's playlist.
Default: radarr_add_missing
Values: true or false
radarr_folder Description: Override Radarr root_folder_path attribute for all playlists in a Defaults file.
Values: Folder Path
radarr_folder_<<key>>1 Description: Override Radarr root_folder_path attribute of the specified key's playlist.
Default: radarr_folder
Values: Folder Path
radarr_tag Description: Override Radarr tag attribute for all playlists in a Defaults file.
Values: List or comma-separated string of tags
radarr_tag_<<key>>1 Description: Override Radarr tag attribute of the specified key's playlist.
Default: radarr_tag
Values: List or comma-separated string of tags
item_radarr_tag Description: Used to append a tag in Radarr for every movie found by the builders that's in Radarr for all playlists in a Defaults file.
Values: List or comma-separated string of tags
item_radarr_tag_<<key>>1 Description: Used to append a tag in Radarr for every movie found by the builders that's in Radarr of the specified key's playlist.
Default: item_radarr_tag
Values: List or comma-separated string of tags
sonarr_add_missing Description: Override Sonarr add_missing attribute for all playlists in a Defaults file.
Values: true or false
sonarr_add_missing_<<key>>1 Description: Override Sonarr add_missing attribute of the specified key's playlist.
Default: sonarr_add_missing
Values: true or false
sonarr_folder Description: Override Sonarr root_folder_path attribute for all playlists in a Defaults file.
Values: Folder Path
sonarr_folder_<<key>>1 Description: Override Sonarr root_folder_path attribute of the specified key's playlist.
Default: sonarr_folder
Values: Folder Path
sonarr_tag Description: Override Sonarr tag attribute for all playlists in a Defaults file.
Values: List or comma-separated string of tags
sonarr_tag_<<key>>1 Description: Override Sonarr tag attribute of the specified key's playlist.
Default: sonarr_tag
Values: List or comma-separated string of tags
item_sonarr_tag Description: Used to append a tag in Sonarr for every series found by the builders that's in Sonarr for all playlists in a Defaults file.
Values: List or comma-separated string of tags
item_sonarr_tag_<<key>>1 Description: Used to append a tag in Sonarr for every series found by the builders that's in Sonarr of the specified key's playlist.
Default: item_sonarr_tag
Values: List or comma-separated string of tags
  1. Each default collection has a key that when calling to effect a specific collection you must replace <<key>> with when calling.

The below is an example config.yml extract with some Template Variables added in to change how the file works.

playlist_files:
  - pmm: playlist
    template_variables:
      radarr_add_missing: true

Default values

These are lists provided for reference to show what values will be in use if you do no customization. If you want to customize these values, use the methods described above. These do not show how to change a name or a list.

Default trakt_list

The below Trakt lists are used to populate the playlists associated with the keys.

trakt_list:
  arrow: https://trakt.tv/users/donxy/lists/arrowverse
  dcau: https://trakt.tv/users/donxy/lists/dc-animated-series-universe
  dragonball: https://trakt.tv/users/grawler/lists/dragon-ball-in-order
  mcu: https://trakt.tv/users/donxy/lists/marvel-cinematic-universe
  pokemon: https://trakt.tv/users/munch54/lists/pokemon-watching-order
  startrek: https://trakt.tv/users/goodevilgenius/lists/star-trek-chronology
  starwars: https://trakt.tv/users/ruben_vw_/lists/star-wars-canon-timeline
  clonewars: https://trakt.tv/users/tomfin46/lists/star-wars-the-clone-wars-chronological-episode-order
  xmen: https://trakt.tv/users/heyitsbea/lists/x-men