Plex-Meta-Manager/docs/config/radarr.md
2024-03-22 11:33:08 +00:00

10 KiB

search
boost
3

Radarr Attributes

Configuring Radarr is optional but will allow you to send movies to a Radarr instance when they're found missing while updating a library's collections.

???+ warning

Radarr V2 may work, but it is not supported. Please upgrade to V3 if you can.

Items in your List Exclusions will be ignored by PMM.

A radarr mapping can be either in the root of the config file as global mapping for all libraries, or you can specify the radarr mapping individually per library.

At the library level, only those settings which are different to the global settings need to be specified; there is an example of this at the end of the page.

Below is a radarr mapping example and the full set of attributes:

radarr:
  url: http://192.168.1.12:32788
  token: ################################
  add_missing: false
  add_existing: false
  upgrade_existing: false
  monitor_existing: false
  root_folder_path: S:/Movies
  monitor: false
  availability: announced
  quality_profile: HD-1080p
  tag: pmm
  search: false
  radarr_path: /media
  plex_path: /share/CACHEDEV1_DATA/Multimedia
Attribute Allowed Values Default Required
url Radarr URL (Including URL Base if set).
Example: http://192.168.1.12:32788
N/A :fontawesome-solid-circle-check:{ .green }
token Radarr API Token. N/A :fontawesome-solid-circle-check:{ .green }
add_missing Adds all missing movies found from all collections to Radarr.
Use the radarr_add_missing Radarr Setting in the collection definition to add missing per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
add_existing Adds all existing movies in collections to Radarr.
Use the radarr_add_existing Radarr Setting in the collection definition to add existing per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
upgrade_existing Upgrades all existing movies in collections to match the Quality Profile of the collection.
Use the radarr_upgrade_existing Radarr Setting in the collection definition to upgrade the Quality Profile per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
monitor_existing Ensures all existing movies in collections match your monitor setting.
Use the radarr_monitor_existing Radarr Setting in the collection definition to match the monitor setting per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
ignore_cache Ignores PMM's cache when adding items to Radarr.
Use the radarr_ignore_cache Radarr Setting in the collection definition to ignore per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
root_folder_path Default Root Folder Path to use when adding new movies.
Use the radarr_folder Radarr Setting in the collection definition to set the Root Folder per collection.
N/A :fontawesome-solid-circle-check:{ .green }
monitor Monitor the movie when adding new movies.
Use the radarr_monitor Radarr Setting in the collection definition to set the Monitor value per collection.
Options: true, false
true :fontawesome-solid-circle-xmark:{ .red }
availability Default Minimum Availability to use when adding new movies.
Use the radarr_availability Radarr Setting in the collection definition to set the Availability per collection.
Options: announced, cinemas, released, db
announced :fontawesome-solid-circle-check:{ .green }
quality_profile Default Quality Profile to use when adding new movies.
Use the radarr_quality Radarr Setting in the collection definition to set the Quality Profile per collection.
N/A :fontawesome-solid-circle-check:{ .green }
tag Default list or comma-separated string of tags to use when adding new movies.
Use the radarr_tag Radarr Setting in the collection definition to set the Tags per collection.
:fontawesome-solid-circle-xmark:{ .red }
search Start search for missing movie when adding new movies.
Use the radarr_search Radarr Setting in the collection definition to set the search value per collection.
boolean: true or false
false :fontawesome-solid-circle-xmark:{ .red }
plex_path When using add_existing or radarr_add_all Convert this part of the path to radarr_path. :fontawesome-solid-circle-xmark:{ .red }
radarr_path When using add_existing or radarr_add_all Convert the plex_path part of the path to this. :fontawesome-solid-circle-xmark:{ .red }

???+ tip

The `token` can be found by going to `Radarr > Settings > General > Security > API Key`

The `quality_profile` must be the exact name of the desired quality profile, including all spaces and 
capitalization.
  • You can set most attributes per collection by using the Radarr Settings in the collection definition.

Radarr Details

Based on that UI, the settings would be [settings not based on things in this image are shown as #; url and token are of course required they are not shown here to focus on the settings that are shown above]:

radarr:
  url: #
  token: #
  add_missing: #
  add_existing: #
  upgrade_existing: #
  monitor_existing: #
  root_folder_path: /movies
  monitor: false
  availability: announced
  quality_profile: HD-1080p
  tag: 
  search: true
  radarr_path: #
  plex_path: #

Other examples:

Specifying different options for specific libraries:

In this example we have two Radarr instances, standard and 4K, and four libraries showing how one can override individual settings at the library level. Also, movies are being added to the "Library05" library outside Radarr via a custom script and I want those new movies added to Radarr for tracking.

libraries:
  Library01:     # this library uses the default radarr config
    collection_files:
      - file: config/Movies.yml

  Library02:     # this library overrides radarr root path and profile
    collection_files:
      - file: config/Movies.yml
    radarr:
      root_folder_path: /data/media/movies/tony
      quality_profile: Better

  Library03:      # this library overrides radarr quality profile
    collection_files:
      - file: config/Movies.yml
    radarr:
      quality_profile: Best

  Library04:      # this library uses the 4K radarr instance
    collection_files:
      - file: config/Movies.yml
    radarr:
      url: https://radarr-4k.bing.bang
      token: SOME_OTHER_TOKEN
      root_folder_path: /data/media/movies/geezer
      quality_profile: Bestest

  Library05:      # movies get added by a custom script so they should get added to radarr-4k
    collection_files:
      - file: config/Movies.yml
    radarr:
      url: https://radarr-4k.bing.bang
      token: SOME_OTHER_TOKEN
      root_folder_path: /data/media/movies/bill
      quality_profile: Bestest
      add_existing: true
      sonarr_path: /data/media/movies/bill
      plex_path: /mnt/unionfs/movies/bill
...
radarr:
  url: https://radarr.bing.bang
  token: SOME_TOKEN
  quality_profile: Good
  add_missing: true
  add_existing: false
  upgrade_existing: false
  monitor_existing: false
  root_folder_path: /movies
  monitor: false
  availability: released
  tag:
  search: false
  radarr_path:
  plex_path:
...