Plex-Meta-Manager/docs/config/sonarr.md

171 lines
23 KiB
Markdown
Raw Normal View History

2023-11-06 20:38:00 +00:00
---
search:
boost: 3
---
2022-03-08 08:06:22 +00:00
# Sonarr Attributes
2023-12-31 16:45:00 +00:00
Configuring [Sonarr](https://sonarr.tv/) is optional but will allow you to send shows to a Sonarr instance when they're
found missing while updating a library's collections.
2022-03-08 08:06:22 +00:00
2023-12-31 16:45:00 +00:00
???+ warning
Sonarr V2 may work, but it is not supported please upgrade to V3 if you can.
2022-03-08 08:06:22 +00:00
2024-04-22 14:20:12 +00:00
Items in your List Exclusions will be ignored by Kometa.
2022-03-24 14:10:27 +00:00
2023-12-31 16:45:00 +00:00
A `sonarr` mapping can be either in the root of the config file as global mapping for all libraries, or you can specify
the `sonarr` mapping individually per library.
2022-03-08 08:06:22 +00:00
2023-12-31 16:45:00 +00:00
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.
2023-01-11 15:01:19 +00:00
2022-03-08 08:06:22 +00:00
Below is a `sonarr` mapping example and the full set of attributes:
```YAML
sonarr:
url: http://192.168.1.12:32789
token: ################################
2022-03-18 13:01:12 +00:00
add_missing: false
add_existing: false
upgrade_existing: false
monitor_existing: false
2022-03-08 08:06:22 +00:00
root_folder_path: S:/Shows
monitor: all
quality_profile: HD-1080p
language_profile: English
series_type: standard
season_folder: true
2024-04-22 14:20:12 +00:00
tag: kometa
2022-03-08 08:06:22 +00:00
search: false
cutoff_search: false
sonarr_path: /media
plex_path: /share/CACHEDEV1_DATA/Multimedia
```
2024-04-22 14:20:12 +00:00
| Attribute | Allowed Values | Default | Required |
|:-------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------|:------------------------------------------:|
| `url` | Sonarr URL (Including URL Base if set).<br>**Example:** http://192.168.1.12:32788 | N/A | :fontawesome-solid-circle-check:{ .green } |
| `token` | Sonarr API Token. | N/A | :fontawesome-solid-circle-check:{ .green } |
| `add_missing` | Adds all missing shows found from all collections to Sonarr.<br>Use the `sonarr_add_missing` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to add missing per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `add_existing` | Adds all existing shows in collections to Sonarr.<br>Use the `sonarr_add_existing` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to add existing per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `upgrade_existing` | Upgrades all existing shows in collections to match the Quality Profile of the collection.<br>Use the `sonarr_upgrade_existing` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to upgrade the Quality Profile per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `monitor_existing` | Ensures all existing shows in collections match your monitor setting.<br>Use the `sonarr_monitor_existing` [Sonarr Setting](../files/arr.md#sonarr-definition-settings) in the collection definition to match the monitor setting per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `ignore_cache` | Ignores Kometa's cache when adding items to Sonarr.<br>Use the `sonarr_ignore_cache` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to ignore per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `root_folder_path` | Default Root Folder Path to use when adding new shows.<br>Use the `sonarr_folder` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the Root Folder per collection. | N/A | :fontawesome-solid-circle-check:{ .green } |
| `monitor` | Default Monitor to use when adding new shows.<br>Use the `sonarr_monitor` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the Monitor value per collection.<br>**Values:** <table class="clearTable"><tr><td>`all`</td><td>All episodes except specials</td></tr><tr><td>`future`</td><td>Episodes that have not aired yet</td></tr><tr><td>`missing`</td><td>Episodes that do not have files or have not aired yet</td></tr><tr><td>`existing`</td><td>Episodes that have files or have not aired yet</td></tr><tr><td>`pilot`</td><td>The first episode, all others will be ignored</td></tr><tr><td>`first`</td><td>All episodes of the first season, all others will be ignored</td></tr><tr><td>`latest`</td><td>All episodes of the latest season and future seasons</td></tr><tr><td>`none`</td><td>No episodes</td></tr></table> | `all` | :fontawesome-solid-circle-xmark:{ .red } |
| `quality_profile` | Default Quality Profile to use when adding new shows.<br>Use the `sonarr_quality` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the Quality Profile per collection. | N/A | :fontawesome-solid-circle-check:{ .green } |
| `language_profile` | Default Language Profile to use when adding new shows.<br>Use the `sonarr_language` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the Language Profile per collection. | First Profile | :fontawesome-solid-circle-xmark:{ .red } |
| `series_type` | Default Series Type to use when adding new shows.<br>Use the `sonarr_series` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the Series Type per collection.<br>**Values:** <table class="clearTable"><tr><td>`standard`</td><td>Episodes released with SxxEyy pattern</td></tr><tr><td>`daily`</td><td>Episodes released daily that use year-month-day pattern (2017-05-25)</td></tr><tr><td>`anime`</td><td>Episodes released using an absolute episode number</td></tr></table>`standard`: Episodes released with SxxEyy pattern<br>`daily`: Episodes released daily or less frequently that use year-month-day (2017-05-25)<br>`anime`: Episodes released using an absolute episode number | `standard` | :fontawesome-solid-circle-xmark:{ .red } |
| `season_folder` | Use the Season Folder Option when adding new shows.<br>Use the `sonarr_season` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the season folder value per collection. <br>**boolean:** true or false | true | :fontawesome-solid-circle-xmark:{ .red } |
| `tag` | Default list or comma-separated string of tags to use when adding new shows.<br>Use the `sonarr_tag` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the tags per collection. | ` ` | :fontawesome-solid-circle-xmark:{ .red } |
| `search` | Start search for missing episodes when adding new shows.<br>Use the `sonarr_search` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the search value per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `cutoff_search` | Start search for cutoff unmet episodes when adding new shows.<br>Use the `sonarr_cutoff_search` [Sonarr Settings](../files/arr.md#sonarr-definition-settings) in the collection definition to set the cutoff search value per collection.<br>**boolean:** true or false | false | :fontawesome-solid-circle-xmark:{ .red } |
| `plex_path` | When using `add_existing` or `sonarr_add_all` Convert this part of the path to `sonarr_path`. | ` ` | :fontawesome-solid-circle-xmark:{ .red } |
| `sonarr_path` | When using `add_existing` or `sonarr_add_all` Convert the `plex_path` part of the path to this. | ` ` | :fontawesome-solid-circle-xmark:{ .red } |
2022-03-08 08:06:22 +00:00
???+ tip
The `token` can be found by going to `Sonarr > Settings > General > Security > API Key`
2022-03-08 08:06:22 +00:00
2023-12-31 16:45:00 +00:00
The `quality_profile` and `language_profile` must be the exact name of the desired quality profile, including all
spaces and capitalization.
2022-03-08 08:06:22 +00:00
2023-12-31 16:45:00 +00:00
* You can set most attributes per collection by using the [Sonarr Settings](../files/arr.md#sonarr-definition-settings)
in the collection definition.
2022-03-29 15:30:30 +00:00
2023-12-31 16:45:00 +00:00
![Sonarr Details](images/sonarr.png)
2022-03-29 15:30:30 +00:00
2023-12-31 16:45:00 +00:00
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]:
```YAML
sonarr:
2023-09-04 22:50:32 +00:00
url: #
token: #
add_missing: #
add_existing: #
upgrade_existing: #
monitor_existing: #
root_folder_path: /share
monitor: all
quality_profile: Any
language_profile: English
series_type: standard
season_folder: true
tag:
search: false
cutoff_search: false
2023-09-04 22:50:32 +00:00
sonarr_path: #
plex_path: #
```
2022-03-29 15:30:30 +00:00
# Other examples:
Specifying a second Sonarr instance for a specific library:
2023-12-31 16:45:00 +00:00
In this example we have two Sonarr instances, standard and 4K, with five libraries that override various details. Also,
shows are being added to the "Library05" library outside Sonarr via a custom script and I want those new shows added to
Sonarr for tracking.
2022-03-29 15:30:30 +00:00
2023-01-11 15:01:19 +00:00
```
2022-03-29 15:30:30 +00:00
libraries:
2023-01-11 15:01:19 +00:00
Library01: # this library uses the default sonarr config
collection_files:
2023-01-11 15:01:19 +00:00
- file: config/TV.yml
Library02: # this library overrides sonarr root path and profile
collection_files:
2023-01-11 15:01:19 +00:00
- file: config/TV.yml
2023-02-07 23:05:47 +00:00
sonarr:
2023-01-11 15:01:19 +00:00
root_folder_path: /data/media/shows/tony
quality_profile: Better
Library03: # this library overrides sonarr quality profile
collection_files:
2022-03-29 15:30:30 +00:00
- file: config/TV.yml
2023-02-07 23:05:47 +00:00
sonarr:
2023-01-11 15:01:19 +00:00
quality_profile: Best
Library04: # this library uses the 4K sonarr instance
collection_files:
2022-03-29 15:30:30 +00:00
- file: config/TV.yml
2023-02-07 23:05:47 +00:00
sonarr:
2023-01-11 15:01:19 +00:00
url: https://sonarr-4k.bing.bang
token: SOME_OTHER_TOKEN
root_folder_path: /data/media/shows/geezer
quality_profile: Bestest
Library05: # shows get added by a custom script so they should get added to sonarr-4k
collection_files:
2023-01-11 15:01:19 +00:00
- file: config/TV.yml
2023-02-07 23:05:47 +00:00
sonarr:
2023-01-11 15:01:19 +00:00
url: https://sonarr-4k.bing.bang
token: SOME_OTHER_TOKEN
root_folder_path: /data/media/shows/bill
quality_profile: Bestest
2022-03-29 15:30:30 +00:00
add_existing: true
2023-01-11 15:01:19 +00:00
sonarr_path: /data/media/shows/bill
plex_path: /mnt/unionfs/shows/bill
2022-03-29 15:30:30 +00:00
...
sonarr:
url: https://sonarr.bing.bang
token: SOME_TOKEN
add_missing: false
add_existing: false
upgrade_existing: false
monitor_existing: false
2023-01-11 15:01:19 +00:00
root_folder_path: /data/media/shows/ozzy
2022-03-29 15:30:30 +00:00
monitor: all
2023-01-11 15:01:19 +00:00
quality_profile: Good
2022-03-29 15:30:30 +00:00
language_profile: English
series_type: standard
season_folder: true
tag:
search: false
cutoff_search: false
sonarr_path:
plex_path:
...
```