You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
244 lines
9.9 KiB
244 lines
9.9 KiB
Reference documentation for the YAML configuration. For various examples, see the [[Configuration
|
|
Examples]] page.
|
|
|
|
# Summary
|
|
|
|
The Trash Updater program utilizes YAML for its configuration files. The configuration can be set up
|
|
multiple ways, offering a lot of flexibility:
|
|
|
|
- You may use one or more YAML files simultaneously, allowing you to divide your configuration
|
|
properties up in such a way that you can control what gets updated based on which files you
|
|
specify.
|
|
|
|
- Each YAML file may have one or more service configurations. This means you can have one file
|
|
define settings for just Sonarr, Radarr, or both services. The program will only read the
|
|
configuration from the file relevant for the specific service subcommand you specified (e.g.
|
|
`trash sonarr` will only read the Sonarr config in the file, even if Radarr config is present)
|
|
|
|
> **Remember**: If you do not specify the `--config` argument, the program will look for `trash.yml`
|
|
> in the same directory where the executable lives.
|
|
|
|
# YAML Reference
|
|
|
|
Table of Contents
|
|
|
|
- [Sonarr](#sonarr)
|
|
- [Basic Settings](#basic-settings)
|
|
- [Quality Definition Settings](#quality-definition-settings)
|
|
- [Release Profile Settings](#release-profile-settings)
|
|
- [Radarr](#radarr)
|
|
- [Basic Settings](#basic-settings-1)
|
|
- [Quality Definition Settings](#quality-definition-settings-1)
|
|
- [Custom Format Settings](#custom-format-settings)
|
|
|
|
## Sonarr
|
|
|
|
```yml
|
|
sonarr:
|
|
- base_url: http://localhost:8989
|
|
api_key: f7e74ba6c80046e39e076a27af5a8444
|
|
|
|
# Quality Definition Settings
|
|
quality_definition: hybrid
|
|
|
|
# Release Profile Settings
|
|
release_profiles:
|
|
- type: anime
|
|
strict_negative_scores: true
|
|
tags:
|
|
- anime
|
|
- type: series
|
|
strict_negative_scores: false
|
|
filter:
|
|
include_optional: true
|
|
tags:
|
|
- tv
|
|
```
|
|
|
|
### Basic Settings
|
|
|
|
- `base_url` **(Required)**<br>
|
|
The base URL of your Sonarr instance. Basically this is the URL you bookmark to get to the front
|
|
page.
|
|
|
|
- `api_key` **(Required)**<br>
|
|
The API key that Trash Updater should use to synchronize settings to your instance. You can obtain
|
|
your API key by going to `Sonarr > Settings > General` and copy & paste the "API Key" under the
|
|
"Security" group/header.
|
|
|
|
### Quality Definition Settings
|
|
|
|
- `quality_definition` (Optional; *Default: No quality definitions are synced*)<br>
|
|
The quality definition [from the TRaSH Guide's Quality Settings page][sonarr_quality] that should
|
|
be parsed and uploaded to Sonarr. Only the below values are permitted here.
|
|
|
|
- `anime` Represents the "Sonarr Quality Definitions" table specifically for Anime
|
|
|
|
- `series` Represents the "Sonarr Quality Definitions" table intended for normal TV Series.
|
|
Sometimes referred to as non-anime.
|
|
|
|
- `hybrid` A combination of both the `anime` and `series` tables that is calculated by comparing
|
|
each row and taking both the smallest minimum and largest maximum values. The purpose of the
|
|
Hybrid type is to build the most permissive quality definition that the guide will allow. It's a
|
|
good idea to use this one if you want more releases to be blocked by your release profiles
|
|
instead of quality.
|
|
|
|
[sonarr_quality]: https://trash-guides.info/Sonarr/V3/Sonarr-Quality-Settings-File-Size/
|
|
|
|
### Release Profile Settings
|
|
|
|
- `release_profiles` (Optional; *Default: No release profiles are synced*)<br>
|
|
A list of release profiles to parse from the guide. Each object in this list supports the below
|
|
properties.
|
|
|
|
- `type` **(Required)**<br>
|
|
Must be one of the following values:
|
|
|
|
- `anime`: Parse the [Anime Release Profile][sonarr_profile_anime] page from the TRaSH Guide.
|
|
- `series`: Parse the [WEB-DL Release Profile][sonarr_profile_series] page from the TRaSH Guide.
|
|
|
|
- `strict_negative_scores` (Optional; *Default: `false`*)<br>
|
|
Enables preferred term scores less than 0 to be instead treated as "Must Not Contain" (ignored)
|
|
terms. For example, if something is "Preferred" with a score of `-10`, it will instead be put in
|
|
the "Must Not Contains" section of the uploaded release profile. Must be `true` or `false`.
|
|
|
|
- `tags` (Optional; *Default: Empty list*)<br>
|
|
A list of one or more strings representing tags that will be applied to this release profile.
|
|
Tags are created in Sonarr if they do not exist. All tags on an existing release profile (if
|
|
present) are removed and replaced with only the tags in this list. If no tags are specified, no
|
|
tags will be set on the release profile.
|
|
|
|
- `filter` (Optional; *Default: Determined by child properties*)<br>
|
|
Defines various ways that release profile terms from the guide are synchronized with Sonarr. Any
|
|
combination of the below properties may be specified here:
|
|
|
|
- `include_optional` (Optional; *Default: `false`*)<br>
|
|
Set to `true` to include terms marked "Optional" in the guide. If set to `false`, optional
|
|
terms are *not* synchronized to Sonarr.
|
|
|
|
[sonarr_profile_anime]: https://trash-guides.info/Sonarr/V3/Sonarr-Release-Profile-RegEx-Anime/
|
|
[sonarr_profile_series]: https://trash-guides.info/Sonarr/V3/Sonarr-Release-Profile-RegEx/
|
|
|
|
## Radarr
|
|
|
|
```yml
|
|
radarr:
|
|
- base_url: http://localhost:7878
|
|
api_key: bf99da49d0b0488ea34e4464aa63a0e5
|
|
|
|
# Quality Definition Settings
|
|
quality_definition:
|
|
type: movie
|
|
preferred_ratio: 0.5
|
|
|
|
# Custom Format Settings
|
|
delete_old_custom_formats: false
|
|
custom_formats:
|
|
- names:
|
|
- BR-DISK
|
|
- EVO (no WEB-DL)
|
|
- LQ
|
|
- x265 (720/1080p)
|
|
- 3D
|
|
quality_profiles:
|
|
- name: HD-1080p
|
|
- name: HD-720p2
|
|
score: -1000
|
|
- names:
|
|
- TrueHD ATMOS
|
|
- DTS X
|
|
quality_profiles:
|
|
- name: SD
|
|
```
|
|
|
|
### Basic Settings
|
|
|
|
- `base_url` **(Required)**<br>
|
|
The base URL of your Radarr instance. Basically this is the URL you bookmark to get to the front
|
|
page.
|
|
|
|
- `api_key` **(Required)**<br>
|
|
The API key that Trash Updater should use to synchronize settings to your instance. You can obtain
|
|
your API key by going to `Radarr > Settings > General` and copy & paste the "API Key" under the
|
|
"Security" group/header.
|
|
|
|
### Quality Definition Settings
|
|
|
|
- `quality_definition` (Optional; *Default: No quality definitions are synced*)<br>
|
|
Specify information related to Radarr quality definition processing here. Only the following child
|
|
properties are permitted.
|
|
|
|
- `type` **(Required)**<br>
|
|
The quality definition from the [Radarr Quality Settings (File Size)][radarr_quality] page in
|
|
the TRaSH Guides that should be parsed and uploaded to Radarr. Only the below values are
|
|
permitted here.
|
|
- `movie`: Currently the only supported type. Represents the only table on that page and is
|
|
intended for general use with all movies in Radarr.
|
|
|
|
- `preferred_ratio` (Optional; *Default: `1.0`*)<br>
|
|
A value `0.0` to `1.0` that represents the percentage (interpolated) position of that middle
|
|
slider you see when you enable advanced settings on the Quality Definitions page in Radarr. A
|
|
value of `0.0` means the preferred quality will match the minimum quality. Likewise, `1.0` will
|
|
match the maximum quality. A value such as `0.5` will keep it halfway between the two.
|
|
|
|
Any value less than `0` or greater than `1` will result in a warning log printed and the value
|
|
will be clamped.
|
|
|
|
[radarr_quality]: https://trash-guides.info/Radarr/V3/Radarr-Quality-Settings-File-Size/
|
|
|
|
### Custom Format Settings
|
|
|
|
For details on the way Custom Formats are synchronized to Radarr, visit the [[Custom Format
|
|
Synchronization]] page.
|
|
|
|
- `delete_old_custom_formats` (Optional; *Default: `false`*)<br>
|
|
If enabled, custom formats that you remove from your YAML configuration OR that are removed from
|
|
the guide will be deleted from your Radarr instance. Note that this *only* applies to custom
|
|
formats that Trash Updater has synchronized to Radarr. Custom formats that you have added manually
|
|
in Radarr **will not be deleted** if you enable this setting.
|
|
|
|
- `custom_formats` (Optional; *Default: No custom formats are synced*)<br>
|
|
A list of one or more sets of custom format names, each with an optional set of quality profiles
|
|
names that identify which quality profiles to assign the scores for those custom formats to. The
|
|
child properties documented below apply to each element of this list.
|
|
|
|
- `names` **(Required)**<br>
|
|
A list of one or more custom format names to synchronize to Radarr. The names *must* be taken
|
|
from the JSON itself in the guide, for example:
|
|
|
|
```json
|
|
{
|
|
"trash_id": "496f355514737f7d83bf7aa4d24f8169",
|
|
"name": "TrueHD ATMOS",
|
|
"includeCustomFormatWhenRenaming": false
|
|
}
|
|
```
|
|
|
|
You take the value of `"name"` above and add it to the list of names like so:
|
|
|
|
```yml
|
|
names:
|
|
- TrueHD ATMOS
|
|
```
|
|
|
|
> **A Few Things to Remember**
|
|
>
|
|
> - If `delete_old_custom_formats` is set to true, custom formats are **deleted** in Radarr if
|
|
> you remove them from this list.
|
|
> - It's OK for the same custom format to exist in multiple lists of `names`. Trash Updater will
|
|
> only ever synchronize it once. Allowing it to be specified multiple times allows you to
|
|
> assign it to different profiles with different scores.
|
|
|
|
- `quality_profiles` (Optional; *Default: No quality profiles are changed*)<br>
|
|
One or more quality profiles to update with the scores from the custom formats listed above.
|
|
Scores are taken from the guide by default, with an option to override the score for all of
|
|
them. Each object in the list must use the properties below.
|
|
|
|
- `name` **(Required)**<br>
|
|
The name of one of the quality profiles in Radarr.
|
|
|
|
- `score` (Optional; *Default: Use scores from the guide*)<br>
|
|
A positive or negative number representing the score to apply to *all* custom formats listed
|
|
in the `names` list. A score of `0` is also acceptable, which effectively disables the custom
|
|
formats without having to delete them.
|