Custom Formats

Service	Supported
Sonarr (v4)
Radarr

# See "Basic Setup" for `service_type` and `instance_name`
service_type:
  instance_name:
    # Custom Format Configuration
    delete_old_custom_formats: false
    replace_existing_custom_formats: false
    custom_formats:
      - trash_ids:
          - ed38b889b31be83fda192888e2286d83 # BR-DISK
          - 90cedc1fea7ea5d11298bebd3d1d3223 # EVO (no WEBDL)
          - 90a6f9a284dff5103f6346090e6280c8 # LQ
          - dc98083864ea246d05a42df0d05f81cc # x265 (720/1080p)
        assign_scores_to:
          - name: HD-1080p
          - name: HD-720p
            score: -1000
      - trash_ids:
          - 496f355514737f7d83bf7aa4d24f8169 # TrueHD ATMOS
          - 2f22d89048b01681dde8afe203bf2e95 # DTS X
        assign_scores_to:
          - name: SD

For details on the way Custom Formats are synchronized, visit the Custom Format Synchronization page.

delete_old_custom_formats

Optional. Default: false

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.

info

This only applies to custom formats that Recyclarr has synchronized to Radarr. Custom formats that you have added manually in Radarr will not be deleted if you enable this setting.

replace_existing_custom_formats

Optional. Default: false

If enabled (set to true), custom formats matching the guide are always synced to the service, replacing any existing CFs with the same name, whether you created them or not. This means that if you manually create a CF from the guide and make adjustments to it, those changes will be overwritten. If this property is omitted or you specify false, then Recyclarr will skip custom formats that you've manually created from the guide. In other words, it will only touch custom formats that it created to begin with.

custom_formats

Optional. Default: No custom formats are synced

A list of one or more sets of custom formats 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.

trash_ids

Required.

A list of one or more Trash IDs of custom formats to synchronize. There are a couple of ways to obtain Trash IDs (listed in order of preference below). The Trash ID itself is a hash of hexadecimal characters, like 496f355514737f7d83bf7aa4d24f8169.

• Most custom format pages in the TRaSH Guides (like this one) have either tables (with a Trash ID column) or a expandable "JSON" section. You can use these to obtain the Trash ID value.
• From Recyclarr itself using the list custom-formats command.
• Taken from the value of the "trash_id" property directly in the TRaSH Guide JSON files itself.

tip

To ease the readability concerns of using IDs, leave a comment beside the Trash ID in your configuration so it can be easily identified later. If you use list custom-formats, comments are added for you. For example:

trash_ids:
- 5d96ce331b98e077abb8ceb60553aa16 # dovi
- a570d4a0e56a2874b64e5bfa55202a1b # flac

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 trash_ids. Recyclarr will only ever synchronize it once. Allowing it to be specified multiple times allows you to assign it to different profiles with different scores.

assign_scores_to

Optional. Default: No quality profiles are changed

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.

The name of an existing quality profile. This name is not required to appear in the top-level quality_profiles list. If the profile name specified here does not exist, an error will be shown. If you want this profile to be created by Recyclarr, you must also add an entry for it in the previously mentioned quality_profiles list.

score

Optional. Default: Use scores from the guide

A positive or negative number representing the score to apply to all custom formats listed in the trash_ids list. A score of 0 is also acceptable, which effectively disables the custom formats without having to delete them.