Sonarr PVR plugin for Buildarr
Project description
Buildarr Sonarr Plugin
The Buildarr Sonarr plugin (buildarr-sonarr
) is a plugin for Buildarr that adds the capability to configure and manage Sonarr instances.
Sonarr is a PVR application which downloads, renames and manages the lifecycle of TV shows in your media library. It is capable of scanning for higher quality versions of your media and automatically upgrading them when a suitable version is available.
Currently, Sonarr V3 is the only supported version. Sonarr V4 support is planned for the future.
Installation
From version 0.4.0 onwards, the Buildarr Sonarr plugin is now an independent package, developed separately from the core Buildarr package.
When using Buildarr as a standalone application, it can simply be installed using pip
:
$ pip install buildarr buildarr-sonarr
When using Buildarr as a Docker container, the Sonarr plugin is still bundled in the official container (callum027/buildarr
). 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-sonar==<version>"
In Buildarr version 0.3.0 and earlier, the Sonarr plugin was vendored within the core Buildarr package. On these versions, it is not necessary to install the Sonarr plugin separately.
Quick Start
To use the Sonarr plugin, create a sonarr
block within buildarr.yml
, and enter the connection information required for the Buildarr instance to connect to the Sonarr instance you'd like to manage.
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 Sonarr instance.
---
buildarr:
watch_config: true
sonarr:
hostname: "localhost" # Defaults to `sonarr`, or the instance name for instance-specific configs.
port: 8989 # Defaults to 8989.
protocol: "http" # Defaults to `http`.
api_key: "..." # Optional. If undefined, auto-fetch (authentication must be disabled).
Now try a buildarr run
. If the output is similar to the below output, Buildarr was able to connect to your Sonarr instance.
2023-03-29 20:39:50,856 buildarr:1 buildarr.cli.run [INFO] Buildarr version 0.4.0 (log level: INFO)
2023-03-29 20:39:50,856 buildarr:1 buildarr.cli.run [INFO] Loading configuration file '/config/buildarr.yml'
2023-03-29 20:39:50,872 buildarr:1 buildarr.cli.run [INFO] Finished loading configuration file
2023-03-29 20:39:50,874 buildarr:1 buildarr.cli.run [INFO] Loaded plugins: sonarr (0.4.0)
2023-03-29 20:39:50,875 buildarr:1 buildarr.cli.run [INFO] Loading instance configurations
2023-03-29 20:39:50,877 buildarr:1 buildarr.cli.run [INFO] Finished loading instance configurations
2023-03-29 20:39:50,877 buildarr:1 buildarr.cli.run [INFO] Running with plugins: sonarr
2023-03-29 20:39:50,877 buildarr:1 buildarr.cli.run [INFO] Resolving instance dependencies
2023-03-29 20:39:50,877 buildarr:1 buildarr.cli.run [INFO] Finished resolving instance dependencies
2023-03-29 20:39:50,877 buildarr:1 buildarr.cli.run [INFO] Loading secrets file from '/config/secrets.json'
2023-03-29 20:39:50,886 buildarr:1 buildarr.cli.run [INFO] Finished loading secrets file
2023-03-29 20:39:50,886 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Checking secrets
2023-03-29 20:39:50,912 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Connection test successful using cached secrets
2023-03-29 20:39:50,912 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Finished checking secrets
2023-03-29 20:39:50,912 buildarr:1 buildarr.cli.run [INFO] Saving updated secrets file to '/config/secrets.json'
2023-03-29 20:39:50,914 buildarr:1 buildarr.cli.run [INFO] Finished saving updated secrets file
2023-03-29 20:39:50,914 buildarr:1 buildarr.cli.run [INFO] Updating configuration on remote instances
2023-03-29 20:39:50,914 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Getting remote configuration
2023-03-29 20:39:51,406 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Finished getting remote configuration
2023-03-29 20:39:51,463 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Updating remote configuration
2023-03-29 20:39:52,019 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Remote configuration is up to date
2023-03-29 20:39:52,019 buildarr:1 buildarr.cli.run [INFO] <sonarr> (default) Finished updating remote configuration
2023-03-29 20:39:52,019 buildarr:1 buildarr.cli.run [INFO] Finished updating configuration on remote instances
Configuring your Sonarr instance
The following sections cover comprehensive configuration of a Sonarr instance.
Note that these documents do not show how you should configure a Sonarr instance. Rather, they show how you can configure a Sonarr instance the way you want with Buildarr. For more information on how to optimally configure Sonarr, you can refer to the excellent guides from WikiArr and TRaSH-Guides.
- Host Configuration
- Media Management
- Profiles
Dumping an existing Sonarr instance configuration
Buildarr is capable of dumping a running Sonarr instance's configuration.
$ buildarr sonarr dump-config http://localhost:8989 > sonarr.yml
Sonarr instance API key: <Paste API key here>
The dumped YAML object can be placed directly under the sonarr
configuration block, or used as an instance-specific configuration.
Most values are explicitly defined in this dumped configuration, ensuring that when used with Buildarr, the configuration will always remain static.
api_key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d
hostname: localhost
port: 8989
protocol: http
settings:
connect:
definitions:
Trakt:
access_token: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b
auth_user: example
expires: '2023-05-10T15:34:08.117451+00:00'
notification_triggers:
include_health_warnings: false
on_application_update: false
on_episode_file_delete: true
on_episode_file_delete_for_upgrade: true
on_grab: false
on_health_issue: false
on_import: true
on_rename: false
on_series_delete: true
on_upgrade: true
refresh_token: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b
tags: []
download_clients:
definitions:
Transmission:
add_paused: false
category: sonarr
directory: null
enable: true
host: transmission
older_priority: last
password: null
port: 9091
priority: 1
recent_priority: last
remove_completed_downloads: true
remove_failed_downloads: true
tags: []
url_base: /transmission/
use_ssl: false
username: null
enable_completed_download_handling: true
redownload_failed: true
remote_path_mappings:
definitions: []
general:
analytics:
send_anonymous_usage_data: true
backup:
folder: Backups
interval: 7
retention: 28
host:
bind_address: '*'
instance_name: Sonarr (Example)
port: 8989
ssl_port: 9898
url_base: null
use_ssl: false
logging:
log_level: INFO
proxy:
bypass_proxy_for_local_addresses: true
enable: false
hostname: null
ignored_addresses: []
password: null
port: 8080
proxy_type: http
username: null
security:
authentication: none
certificate_validation: enabled
password: null
username: null
updates:
automatic: false
branch: main
mechanism: docker
script_path: null
import_lists:
definitions: {}
indexers:
definitions: {}
maximum_size: 0
minimum_age: 0
retention: 0
rss_sync_interval: 15
media_management:
analyze_video_files: true
anime_episode_format: '{Series TitleYear} - S{season:00}E{episode:00} - {absolute:000}
- {Episode CleanTitle} {[Preferred Words]} {[Quality Full]} {[MediaInfo VideoDynamicRangeType]}
[{MediaInfo VideoBitDepth}bit] {[MediaInfo VideoCodec]} [{Mediainfo AudioCodec}
{ Mediainfo AudioChannels}]{MediaInfo AudioLanguages} {[Release Group]} - Default'
change_file_date: none
chmod_folder: drwxr-xr-x
chown_group: null
create_empty_series_folders: false
daily_episode_format: '{Series TitleYear} - {Air-Date} - {Episode CleanTitle}
- {[Preferred Words]} {[Quality Full]} {[MediaInfo VideoDynamicRangeType]} [{MediaInfo
VideoBitDepth}bit] {[MediaInfo VideoCodec]} [{Mediainfo AudioCodec} {Mediainfo
AudioChannels}] {[MediaInfo AudioLanguages]} {[Release Group]} - Default'
delete_empty_folders: false
episode_title_required: always
import_extra_files: false
minimum_free_space: 100
multiepisode_style: range
propers_and_repacks: do-not-prefer
recycling_bin: null
recycling_bin_cleanup: 7
rename_episodes: true
replace_illegal_characters: true
rescan_series_folder_after_refresh: always
root_folders: []
season_folder_format: Season {season:00}
series_folder_format: '{Series TitleYear} [imdbid-{ImdbId}]'
set_permissions: false
skip_free_space_check: false
specials_folder_format: Specials
standard_episode_format: '{Series TitleYear} - S{season:00}E{episode:00} - {Episode
CleanTitle} - {[Preferred Words]} {[Quality Full]} {[MediaInfo VideoDynamicRangeType]}
[{MediaInfo VideoBitDepth}bit] {[MediaInfo VideoCodec]} [{Mediainfo AudioCodec}
{Mediainfo AudioChannels}] {[MediaInfo AudioLanguages]} {[Release Group]} -
Default'
use_hardlinks: true
metadata:
kodi_emby:
enable: false
episode_images: true
episode_metadata: true
season_images: true
series_images: true
series_metadata: true
series_metadata_url: true
roksbox:
enable: false
episode_images: true
episode_metadata: true
season_images: true
series_images: true
wdtv:
enable: false
episode_images: true
episode_metadata: true
season_images: true
series_images: true
profiles:
delay_profiles:
definitions:
- bypass_if_highest_quality: true
preferred_protocol: usenet-prefer
tags: []
torrent_delay: 0
usenet_delay: 0
language_profiles:
definitions:
Shows:
languages:
- english
upgrade_until: english
upgrades_allowed: true
quality_profiles:
definitions:
SD/HD:
qualities:
- Bluray-1080p
- members:
- WEBDL-1080p
- WEBRip-1080p
name: WEB 1080p
- HDTV-1080p
- Bluray-720p
- members:
- WEBDL-720p
- WEBRip-720p
name: WEB 720p
- HDTV-720p
- Raw-HD
- Bluray-480p
- DVD
- members:
- WEBDL-480p
- WEBRip-480p
name: WEB 480p
- SDTV
upgrade_until: Bluray-1080p
upgrades_allowed: true
release_profiles:
definitions:
'[Trash] Low Quality Groups':
enable: true
include_preferred_when_renaming: false
indexer: null
must_contain: []
must_not_contain: []
preferred:
- score: -10000
term: /(-BRiNK|-CHX|-GHOSTS|-EVO|-FGT|JFF|PSA|MeGusta|-NERO|nhanc3|Pahe\.ph|Pahe\.in|TBS|-VIDEOHOLE|-worldmkv|-XLF)\b/i
tags: []
'[Trash] Optionals':
enable: true
include_preferred_when_renaming: false
indexer: null
must_contain: []
must_not_contain:
- /^(?=.*(1080|720))(?=.*((x|h)[ ._-]?265|hevc)).*/i
- /\b(-alfaHD|-BAT|-BNd|-C\.A\.A|-Cory|-EXTREME|-FF|-FOXX|-G4RiS|-GUEIRA|-N3G4N|-PD|-PTHome|-RiPER|-RK|-SiGLA|-Tars|-WTV|-Yatogam1|-YusukeFLA|-ZigZag)\b/i
- /\b(-scene)\b/i
- /^(?!.*(HDR|HULU|REMUX))(?=.*\b(DV|Dovi|Dolby[- .]?Vision)\b).*/i
- /\bAV1\b/i
- /^(?!.*(web[ ]dl|-deflate|-inflate))(?=.*([_. ]WEB[_. ]|-CAKES\b|-GGEZ\b|-GGWP\b|-GLHF\b|-GOSSIP\b|-KOGI\b|-PECULATE\b|-SLOT\b)).*/i
preferred:
- score: 15
term: /\bS\d+\b(?!E\d+\b)/i
- score: -10000
term: /(-4P|-4Planet|-AsRequested|-BUYMORE|-CAPTCHA|-Chamele0n|-GEROV|-iNC0GNiTO|-NZBGeek|-Obfuscated|-postbot|-Rakuv|-Scrambled|-WhiteRev|-WRTEAM|-xpost)\b/i
- score: -10000
term: /(?<!\d\.)(1-.+)$/i
- score: -10000
term: /(\[rartv\]|\[rarbg\]|\[eztv\]|\[TGx\])/i
- score: -10000
term: /\s?\ben\b$/i
tags: []
'[Trash] P2P Groups + Repack/Proper':
enable: true
include_preferred_when_renaming: false
indexer: null
must_contain: []
must_not_contain: []
preferred:
- score: 1800
term: /(-deflate|-inflate)\b/i
- score: 1700
term: /(-ABBIE|-AJP69|-APEX|-CasStudio|CRFW|-CtrlHD|-FLUX|\bHONE|-KiNGS|-monkee|NOSiViD|-NTb|-NTG|-PAXA|-PEXA|-QOQ|-RTN|-SiC|T6D|-TOMMY|-ViSUM|-XEPA)\b/i
- score: 1650
term: /(3CTWeB|BLUTONiUM|-BTW|-Chotab|-Cinefeel|-CiT|Coo7|-dB|-DEEP|-END|-ETHiCS|-FC|-Flights|-GNOME|-iJP|-iKA|-iT00NZ|-JETIX|-KHN|-KiMCHI|-LAZY|-MZABI|-NPMS|-NYH|-orbitron|playWEB|PSiG|-ROCCaT|RTFM|-SA89|-SDCC|-SIGMA|-SMURF|-SPiRiT|-TEPES|-TVSmash|-WELP)\b/i
- score: 1600
term: /(-DRACULA|SLiGNOME|T4H|-ViSiON|SwAgLaNdEr)\b/i
- score: 13
term: /(repack3)/i
- score: 12
term: /(repack2)/i
- score: 11
term: /\b(repack|proper)\b/i
tags: []
'[Trash] Release Sources (Streaming Service)':
enable: true
include_preferred_when_renaming: true
indexer: null
must_contain: []
must_not_contain: []
preferred:
- score: 100
term: /\b(amzn|amazon)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 100
term: /\b(atvp|aptv|Apple TV\+)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 95
term: /\b(sho|showtime)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 90
term: /\b(dsnp|dsny|disney|Disney\+)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 90
term: /\b(hmax|hbom|hbo[ ._-]max)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 90
term: /\b(nf|netflix)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 90
term: /\b(qibi|quibi)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 85
term: /\b(hulu)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 85
term: /\b(pcok|Peacock TV)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(dcu)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(hbo)(?![ ._-]max)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(it)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(nlz)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(pmtp)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(red)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(stan)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
- score: 75
term: /\b(vdl)\b(?=[ ._-]web[ ._-]?(dl|rip)\b)/i
tags: []
quality:
definitions:
Bluray-1080p:
max: 227.0
min: 50.4
title: null
Bluray-1080p Remux:
max: null
min: 69.1
title: null
Bluray-2160p:
max: null
min: 94.6
title: null
Bluray-2160p Remux:
max: null
min: 204.4
title: null
Bluray-480p:
max: 100.0
min: 2.0
title: null
Bluray-720p:
max: 137.3
min: 17.1
title: null
DVD:
max: 100.0
min: 2.0
title: null
HDTV-1080p:
max: 137.3
min: 15.0
title: null
HDTV-2160p:
max: 350.0
min: 50.4
title: null
HDTV-720p:
max: 67.5
min: 10.0
title: null
Raw-HD:
max: null
min: 4.0
title: null
SDTV:
max: 100.0
min: 2.0
title: null
Unknown:
max: 199.9
min: 1.0
title: null
WEBDL-1080p:
max: 137.3
min: 15.0
title: null
WEBDL-2160p:
max: 350.0
min: 50.4
title: null
WEBDL-480p:
max: 100.0
min: 2.0
title: null
WEBDL-720p:
max: 137.3
min: 10.0
title: null
WEBRip-1080p:
max: 137.3
min: 15.0
title: null
WEBRip-2160p:
max: 350.0
min: 50.4
title: null
WEBRip-480p:
max: 100.0
min: 2.0
title: null
WEBRip-720p:
max: 137.3
min: 10.0
title: null
tags:
definitions: []
ui:
enable_color_impaired_mode: false
first_day_of_week: sunday
long_date_format: day-first
short_date_format: word-month-second
show_relative_dates: true
time_format: twentyfour-hour
week_column_header: day-first
version: 3.0.9.1549
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for buildarr_sonarr-0.5.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cee423746c6243e707b25269aa93dca3bb3da89a229155a37658ebba55d4096a |
|
MD5 | 77c6cf4bbe62e9b7c0250502ae533d8a |
|
BLAKE2b-256 | e9fd75bd618f6ce6bc14c5ab1ddcfc844c16e479d2c6afb013a1ba7e7d671671 |