Buildarr Radarr Plugin#
The Buildarr Radarr plugin (buildarr-radarr) is a plugin for Buildarr that adds the capability to configure and manage Radarr instances.
Radarr is a PVR application which downloads, renames and manages the lifecycle of movies in your media library. In other words, it is to movies what Sonarr is to TV shoes. It can monitor for both upcoming and current releases and grab them when they become available, as well as upgrade to higher quality versions of monitored releases when a suitable version is available.
Currently, Radarr V4 and Radarr V5 are the supported versions. If you are using Radarr V3 or earlier, please upgrade in order to manage your instances with Buildarr.
Installation#
When using Buildarr as a standalone application, the Radarr plugin can simply be installed using pip:
pip install buildarr buildarr-radarr
When using Buildarr as a Docker container, the Radarr plugin is bundled with the official container (callum027/buildarr), so there is no need to install it separately.
You can upgrade, or pin the version of the plugin to a specific version, within the container by setting the $BUILDARR_INSTALL_PACKAGES environment variable in the docker run command using --env/-e:
-e BUILDARR_INSTALL_PACKAGES="buildarr-radarr==<version>"
Quick Start#
To use the Radarr plugin, create a radarr block within buildarr.yml, and enter the connection information required for the Buildarr instance to connect to the Radarr instance you'd like to manage.
If authentication is disabled on your Radarr instance, Buildarr will automatically retrieve the API key from the instance, meaning that you do not need to define it in the configuration.
If authentication is enabled, manually retrieve the API key for Radarr by copying it from Settings -> General -> Security -> API Key, and pasting it into the configuration file as shown below.
---
buildarr:
watch_config: true
radarr:
hostname: localhost # Defaults to `radarr`, or the instance name for instance-specific configs.
port: 7878 # Defaults to 7878.
protocol: http # Defaults to `http`.
api_key: ... # Required if authentication is enabled. Auto-fetch if authentication is disabled.
Buildarr won't modify anything yet since no configuration has been defined, but you are able to test if Buildarr is able to connect to and authenticate with the Radarr instance.
Try a buildarr run. If the output is similar to the below output, Buildarr was able to connect to your Radarr instance.
2023-09-02 18:46:05,366 buildarr:1 buildarr.cli.run [INFO] Buildarr version 0.6.0 (log level: INFO)
2023-09-02 18:46:05,366 buildarr:1 buildarr.cli.run [INFO] Loading configuration file '/config/buildarr.yml'
2023-09-02 18:46:05,403 buildarr:1 buildarr.cli.run [INFO] Finished loading configuration file
2023-09-02 18:46:05,417 buildarr:1 buildarr.cli.run [INFO] Loaded plugins: radarr (0.1.0)
2023-09-02 18:46:05,417 buildarr:1 buildarr.cli.run [INFO] Loading instance configurations
2023-09-02 18:46:05,422 buildarr:1 buildarr.cli.run [INFO] Finished loading instance configurations
2023-09-02 18:46:05,422 buildarr:1 buildarr.cli.run [INFO] Running with plugins: radarr
2023-09-02 18:46:05,422 buildarr:1 buildarr.cli.run [INFO] Resolving instance dependencies
2023-09-02 18:46:05,422 buildarr:1 buildarr.cli.run [INFO] Finished resolving instance dependencies
2023-09-02 18:46:05,422 buildarr:1 buildarr.cli.run [INFO] Fetching TRaSH metadata
2023-09-02 18:46:09,856 buildarr:1 buildarr.cli.run [INFO] Finished fetching TRaSH metadata
2023-09-02 18:46:09,856 buildarr:1 buildarr.cli.run [INFO] Rendering instance configuration dynamic attributes
2023-09-02 18:46:09,856 buildarr:1 buildarr.cli.run [INFO] Finished rendering instance configuration dynamic attributes
2023-09-02 18:46:09,856 buildarr:1 buildarr.cli.run [INFO] Loading secrets file from '/config/secrets.json'
2023-09-02 18:46:09,857 buildarr:1 buildarr.cli.run [INFO] Finished loading secrets file
2023-09-02 18:46:09,857 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Checking secrets
2023-09-02 18:46:09,869 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Connection test successful using cached secrets
2023-09-02 18:46:09,869 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Finished checking secrets
2023-09-02 18:46:09,870 buildarr:1 buildarr.cli.run [INFO] Saving updated secrets file to '/config/secrets.json'
2023-09-02 18:46:09,871 buildarr:1 buildarr.cli.run [INFO] Finished saving updated secrets file
2023-09-02 18:46:09,871 buildarr:1 buildarr.cli.run [INFO] Performing post-initialisation configuration render
2023-09-02 18:46:10,092 buildarr:1 buildarr.cli.run [INFO] Finished performing post-initialisation configuration render
2023-09-02 18:46:10,092 buildarr:1 buildarr.cli.run [INFO] Updating configuration on remote instances
2023-09-02 18:46:10,092 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Fetching remote configuration to check if updates are required
2023-09-02 18:46:10,446 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Finished fetching remote configuration
2023-09-02 18:46:10,522 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Updating remote configuration
2023-09-02 18:46:10,840 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Remote configuration is up to date
2023-09-02 18:46:10,840 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Finished updating remote configuration
2023-09-02 18:46:10,840 buildarr:1 buildarr.cli.run [INFO] Finished updating configuration on remote instances
2023-09-02 18:46:10,840 buildarr:1 buildarr.cli.run [INFO] Deleting unmanaged/unused resources on remote instances
2023-09-02 18:46:10,840 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Refetching remote configuration to delete unused resources
2023-09-02 18:46:11,171 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Finished refetching remote configuration
2023-09-02 18:46:11,263 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Deleting unmanaged/unused resources on the remote instance
2023-09-02 18:46:11,442 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Remote configuration is clean
2023-09-02 18:46:11,442 buildarr:1 buildarr.cli.run [INFO] <radarr> (default) Finished deleting unmanaged/unused resources on the remote instance
2023-09-02 18:46:11,442 buildarr:1 buildarr.cli.run [INFO] Finished deleting unmanaged/unused resources on remote instances
2023-09-02 18:46:11,442 buildarr:1 buildarr.cli.run [INFO] Deleting downloaded TRaSH metadata
2023-09-02 18:46:11,461 buildarr:1 buildarr.cli.run [INFO] Finished deleting downloaded TRaSH metadata
Configuring your Buildarr instance#
The following sections cover comprehensive configuration of a Radarr instance.
Note that these documents do not show how you should configure a Radarr instance. Rather, they show how you can configure a Radarr instance the way you want with Buildarr. For more information on how to optimally configure Radarr, you can refer to the excellent guides from WikiArr and TRaSH-Guides.
Note
Configuration of the following resources are not yet supported by this plugin (but will be added in future versions):
- Import Lists
- Indexer Restrictions (Radarr V4 only)
- Release Profiles (Radarr V5+)
- Host Configuration
- Settings
Dumping an existing Radarr instance configuration#
Buildarr is capable of dumping a running Radarr instance's configuration.
$ buildarr radarr dump-config http://localhost:7878 > radarr.yml
Radarr instance API key: <Paste API key here>
The dumped YAML object can be placed directly under the radarr configuration block, or used as an instance-specific configuration.
All possible values are explicitly defined in this dumped configuration.
hostname: localhost
port: 7878
protocol: http
api_key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d
image: lscr.io/linuxserver/radarr
version: 4.7.5.7809
settings:
media_management:
rename_movies: true
replace_illegal_characters: true
colon_replacement: space-dash-space
standard_movie_format: '{Movie CleanTitle} - {Edition Tags }{[Custom Formats]
}{[Quality Full] }{[MediaInfo 3D] }{[MediaInfo VideoDynamicRangeType] }[{Mediainfo
AudioCodec}{ Mediainfo AudioChannels}]{ [Mediainfo VideoCodec]}{ [Release Group]}
- Default'
movie_folder_format: '{Movie CleanTitle} ({Release Year}) [imdbid-{ImdbId}]'
create_missing_movie_folders: false
delete_empty_folders: false
skip_free_space_check: false
minimum_free_space: 100
use_hardlinks: true
import_using_script: false
import_script_path: null
import_extra_files: false
unmonitor_deleted_movies: false
propers_and_repacks: do-not-prefer
analyze_video_files: true
rescan_folder_after_refresh: always
change_file_date: none
recycling_bin: null
recycling_bin_cleanup: 28
set_permissions: false
chmod_folder: drwxr-xr-x
chown_group: null
root_folders:
delete_unmanaged: false
definitions: []
profiles:
quality_profiles:
delete_unmanaged: false
definitions:
Movies:
upgrades_allowed: true
qualities:
- Bluray-1080p
- name: WEB 1080p
members:
- WEBRip-1080p
- WEBDL-1080p
- Bluray-720p
- name: WEB 720p
members:
- WEBDL-720p
- WEBRip-720p
- Bluray-576p
- Bluray-480p
- name: WEB 480p
members:
- WEBDL-480p
- WEBRip-480p
- name: DVD-Video
members:
- DVD-R
- DVD
upgrade_until_quality: Bluray-1080p
minimum_custom_format_score: 0
upgrade_until_custom_format_score: 10000
custom_formats:
- name: 4k-remaster
score: 25
- name: remaster
score: 25
language: English
delay_profiles:
definitions:
- preferred_protocol: torrent-prefer
usenet_delay: 0
torrent_delay: 1440
bypass_if_highest_quality: true
tags: []
delete_unmanaged: false
quality:
trash_id: null
definitions:
Unknown:
title: null
min: 0.0
preferred: 3.3
max: null
WORKPRINT:
title: null
min: 0.0
preferred: 95.0
max: 100.0
CAM:
title: null
min: 0.0
preferred: 95.0
max: 100.0
TELESYNC:
title: null
min: 0.0
preferred: 95.0
max: 100.0
TELECINE:
title: null
min: 0.0
preferred: 95.0
max: 100.0
REGIONAL:
title: null
min: 0.0
preferred: 95.0
max: 100.0
DVDSCR:
title: null
min: 0.0
preferred: 95.0
max: 100.0
SDTV:
title: null
min: 0.0
preferred: 95.0
max: 100.0
DVD:
title: null
min: 0.0
preferred: 95.0
max: 100.0
DVD-R:
title: null
min: 0.0
preferred: 95.0
max: 100.0
WEBDL-480p:
title: null
min: 0.0
preferred: 95.0
max: 100.0
WEBRip-480p:
title: null
min: 0.0
preferred: 95.0
max: 100.0
Bluray-480p:
title: null
min: 0.0
preferred: 95.0
max: 100.0
Bluray-576p:
title: null
min: 0.0
preferred: 95.0
max: 100.0
HDTV-720p:
title: null
min: 17.1
preferred: 95.0
max: null
WEBDL-720p:
title: null
min: 12.5
preferred: 95.0
max: null
WEBRip-720p:
title: null
min: 12.5
preferred: 95.0
max: null
Bluray-720p:
title: null
min: 25.7
preferred: 95.0
max: null
HDTV-1080p:
title: null
min: 33.8
preferred: 95.0
max: null
WEBDL-1080p:
title: null
min: 12.5
preferred: 95.0
max: null
WEBRip-1080p:
title: null
min: 12.5
preferred: 95.0
max: null
Bluray-1080p:
title: null
min: 50.8
preferred: null
max: null
Remux-1080p:
title: null
min: 136.8
preferred: null
max: null
HDTV-2160p:
title: null
min: 85.0
preferred: null
max: null
WEBDL-2160p:
title: null
min: 34.5
preferred: null
max: null
WEBRip-2160p:
title: null
min: 34.5
preferred: null
max: null
Bluray-2160p:
title: null
min: 102.0
preferred: null
max: null
Remux-2160p:
title: null
min: 187.4
preferred: null
max: null
BR-DISK:
title: null
min: 0.0
preferred: null
max: null
Raw-HD:
title: null
min: 0.0
preferred: null
max: null
custom_formats:
delete_unmanaged: false
definitions:
remaster:
trash_id: null
default_score: null
include_when_renaming: false
delete_unmanaged_conditions: false
conditions:
Not 4K Remaster:
negate: true
required: true
type: release-title
regex: 4K
Remaster:
negate: false
required: true
type: release-title
regex: Remaster
4k-remaster:
trash_id: null
default_score: null
include_when_renaming: false
delete_unmanaged_conditions: false
conditions:
4K:
negate: false
required: true
type: release-title
regex: 4k
Not 4K Resolution:
negate: true
required: true
type: resolution
resolution: r2160p
Remaster:
negate: false
required: true
type: release-title
regex: Remaster
indexers:
minimum_age: 0
retention: 0
maximum_size: 0
rss_sync_interval: 60
delete_unmanaged: false
definitions:
1337x (Prowlarr):
enable_rss: true
enable_automatic_search: true
enable_interactive_search: true
priority: 25
download_client: null
tags: []
minimum_seeders: 2
seed_ratio: null
seed_time: null
type: torznab
base_url: http://prowlarr:9696/1/
api_path: /api
api_key: f6e5d4c3b2a10f6e5d4c3b2a10f6e5d4
multi_languages: []
categories:
- MOVIES-FOREIGN
- MOVIES-SD
- MOVIES-DVD
- MOVIES-HD
additional_parameters: null
download_clients:
delete_unmanaged: false
definitions:
Transmission:
enable: true
priority: 1
remove_completed: true
tags: []
host: transmission
port: 9091
use_ssl: false
url_base: /transmission/
username: null
password: null
category: null
directory: /data/torrents/movies
recent_priority: last
older_priority: last
add_paused: false
type: transmission
notifications:
delete_unmanaged: false
definitions: {}
metadata:
certification_country: us
emby_legacy:
enable: false
movie_metadata: true
kodi_emby:
enable: false
movie_metadata: true
movie_metadata_url: false
movie_metadata_language: english
movie_images: true
use_movie_nfo: false
add_collection_name: true
roksbox:
enable: false
movie_metadata: true
movie_images: true
wdtv:
enable: false
movie_metadata: true
movie_images: true
tags:
definitions:
- sup
general:
host:
bind_address: '*'
port: 7878
ssl_port: 9898
use_ssl: false
ssl_cert_path: null
ssl_cert_password: null
url_base: null
instance_name: Radarr
security:
authentication: none
username: null
password: null
certificate_validation: enabled
proxy:
enable: false
proxy_type: http
hostname: null
port: 8080
username: null
password: null
ignored_addresses: []
bypass_proxy_for_local_addresses: true
logging:
log_level: INFO
analytics:
send_anonymous_usage_data: false
updates:
branch: master
automatic: false
mechanism: docker
script_path: null
backup:
folder: Backups
interval: 7
retention: 28
ui:
first_day_of_week: monday
week_column_header: day-first
runtime_format: hours-minutes
short_date_format: slash-day-first
long_date_format: day-first
time_format: twentyfour-hour
show_relative_dates: true
theme: auto
enable_color_impaired_mode: false
movie_info_language: english
ui_language: english