Skip to main content

The documentation here is for an unreleased version of Recyclarr.

Visit the documentation site for the Current Version instead.

Quality Profiles

Unsupported Features

Language

At the moment, it is not possible to set the language in a quality profile through Recyclarr. If you need to specify a language, you must do so manually through the Radarr/Sonarr UI. The reason why language is not supported is because both Radarr and Sonarr do it differently. Sonarr v4, for example, has removed the field entirely. You would use a custom format to specify a language instead. It is expected that in the future, Radarr follows suit. Because of this inconsistency, Recyclarr did not adopt support for it.

Quality Sort Modes

The quality_sort property supports various different sort algorithms. Before we dive into the differences between these sort algorithms and why you would choose one or the other, we need a basic understanding of why quality ordering matters in the first place.

Why Order Matters

It's important to know that even when a quality is disabled in your quality profile, its order still matters for the following reasons:

  • Manual search results, by default, are sorted based on the order of the qualities in your quality profile.
  • Whether a cutoff is met or not is still impacted by disabled qualities.

Because disabled (disallowed) qualities are not technically non-functional, the sort mode exists to give you some flexibility in how those disabled qualities impact you when they're missing from the qualities list in your configuration YAML.

Top Sort

When quality_sort is set to top (which is also the default if you do not specify this property), qualities and groups you explicitly specify in your YAML are sorted to the top of the list. Unspecified qualities appear at the bottom.

Impact on Cutoff

If qualities are removed instead of disabled, this can cause unwanted downgrades of movie files.

Example

Click to Expand Example
quality_sort: top
qualities:
- name: Remux-1080p
- name: Bluray-1080p
enabled: false
- name: Bluray-720p
- name: WEB 720p
qualities:
- WEBRip-720p
- WEBDL-720p
- name: DVD

When you sync this quality profile, it will look like this when you view it in the Radarr UI:

Bottom Sort

When quality_sort is set to bottom, qualities and groups you explicitly specify in your YAML are sorted to the bottom of the list. Unspecified qualities appear at the top.

Impact on Cutoff

If qualities are removed instead of disabled, this can result in upgrades never happening.

Example

Click to Expand Example

Using the same example YAML from the previous section:

quality_sort: bottom
qualities:
- name: Remux-1080p
- name: Bluray-1080p
enabled: false
- name: Bluray-720p
- name: WEB 720p
qualities:
- WEBRip-720p
- WEBDL-720p
- name: DVD

Syncing this will yield the following qualities list when you view them from the Radarr UI: