open-source-mirrors
/
recyclarr
mirror of https://github.com/recyclarr/recyclarr
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
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.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '899ff1571e'
${ noResults }
recyclarr/wiki/Configuration-Reference.md

5.9 KiB
Raw Blame History

Reference documentation for the YAML documentation. For various configuration 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

Sonarr

sonarr:
  - base_url: http://localhost:8989
    api_key: f7e74ba6c80046e39e076a27af5a8444

    # Quality definitions from the guide to sync to Sonarr.
    quality_definition: hybrid

    # Release profiles from the guide to sync to Sonarr.
    release_profiles:
      - type: anime
        strict_negative_scores: true
        tags:
          - anime
      - type: series
        strict_negative_scores: false
        tags:
          - tv

  • base_url (Required)
    The base URL of your Sonarr instance. Basically this is the URL you bookmark to get to the front page.

  • api_key (Required)
    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 (Optional)
    The quality definition from the TRaSH Guide's Quality Settings page 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.

  • release_profiles (Optional)
    A list of release profiles to parse from the guide. Each object in this list supports the below properties.

    • type (Required): Must be one of the following values:

    • strict_negative_scores (Optional): 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. The default value is false if omitted.

    • tags (Optional): 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.

Radarr

radarr:
  - base_url: http://localhost:7878
    api_key: bf99da49d0b0488ea34e4464aa63a0e5

    # Which quality definition in the guide to sync to Radarr.
    quality_definition:
      type: movie
      preferred_ratio: 0.5

  • base_url (Required)
    The base URL of your Radarr instance. Basically this is the URL you bookmark to get to the front page.

  • api_key (Required)
    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 (Optional)
    Specify information related to Radarr quality definition processing here. Only the following child properties are permitted.

    • type (Required): The quality definition from the Radarr Quality Settings (File Size) 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) 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.

      If not specified, the default value is 1.0. Any value less than 0 or greater than 1 will result in a warning log printed and the value will be clamped.