Delay Profiles#

Delay profiles allow you to reduce the number of releases that will be downloaded for an episode by adding a delay while Sonarr continues to watch for releases that better match your preferences.

sonarr:
  settings:
    profiles:
      delay_profiles:
        # Set to `true` or `false` as desired. (Default `false`)
        # Works a bit differently to other profile types, see
        # the `delete_unmanaged` attribute docs.
        delete_unmanaged: true
        definitions:
          # Ordered in priority, highest priority first.
          - preferred_protocol: "usenet-prefer"
            usenet_delay: 0
            torrent_delay: 0
            bypass_if_highest_quality: true
            tags:
              - "tv-shows"
          # Add additional delay profiles here as needed.
          ...
          # Default delay profile goes last, and MUST be defined
          # if you have defined any other delay profiles.
          - preferred_protocol: "torrent-prefer"
            usenet_delay: 1440
            torrent_delay: 1440
            bypass_if_highest_quality: false
            # Tags will be ignored for default delay profile.

In Buildarr, due to the unique way how delay profiles work, they are defined using an ordered list structure, prioritised from first to last (top to bottom). The last delay profile in the list is assumed to be the default delay profile. Every non-default delay profile must have tags defined, and the default delay profile must have no tags defined.

For more information, see this guide from WikiArr.

General configuration#

Configuration parameters for controlling how Buildarr handles delay profiles.

delete_unmanaged = False class-attribute instance-attribute #

Controls how Buildarr manages existing delay profiles in Sonarr when no delay profiles are defined in Buildarr.

When set to True and there are no delay profiles defined in Buildarr, delete all delay profiles except the default delay profile (which can't be deleted).

When set to False and there are no delay profiles defined in Buildarr, do not modify the existing delay profiles in Sonarr at all.

Due to the unique way delay profiles are structured, when they are defined in Buildarr, they always overwrite the existing delay profiles on the remote Sonarr instance and configure it exactly as laid out in Buildarr, irrespective of this value.

If unsure, leave this value set to False.

definitions: List[DelayProfile] = [] class-attribute instance-attribute #

Define delay profiles to configure on Sonarr here.

The final delay profile in the list is assumed to be the default delay profile.

Creating a delay profile#

Delay profiles are defined as an ordered list of objects.

A preferred protocol must be specified for all delay profiles. Tags must be defined on all except the final profile (the default profile), where tags must not be defined.

...
  delay_profiles:
    definitions:
      # Ordered in priority, highest priority first.
      - preferred_protocol: "usenet-prefer" # Required
        usenet_delay: 0
        torrent_delay: 0
        bypass_if_highest_quality: true
        tags:
          - "tv-shows"
        # Add additional delay profiles here as needed.
        ...
        # Default delay profile goes last, and MUST be defined
        # if you have defined any other delay profiles.
        - preferred_protocol: "torrent-prefer" # Required
          usenet_delay: 1440
          torrent_delay: 1440
          bypass_if_highest_quality: false
          # Tags will be ignored for default delay profile.
preferred_protocol: PreferredProtocol instance-attribute #

Choose which protocol(s) to use and which one is preferred when choosing between otherwise equal releases.

Values:

  • usenet-prefer (Prefer Usenet)
  • torrent-prefer (Prefer Torrent)
  • usenet-only (Only Usenet)
  • torrent-only (Only Torrent)
usenet_delay: int = Field(0, ge=0) class-attribute instance-attribute #

Delay (in minutes) to wait before grabbing a release from Usenet.

torrent_delay: int = Field(0, ge=0) class-attribute instance-attribute #

Delay (in minutes) to wait before grabbing a torrent.

bypass_if_highest_quality: bool = False class-attribute instance-attribute #

Bypass the delay if a found release is the highest quality allowed in the quality profile that applies to it, and uses the preferred protocol as defined in this delay profile.

tags: Set[NonEmptyStr] = set() class-attribute instance-attribute #

Tags to assign to this delay profile.

This delay profile will apply to series with at least one matching tag.