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.
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.
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: