Quality Profiles - Luminarr Docs

Overview

What is a Quality Profile?

A quality profile is a set of rules that govern which releases Luminarr will accept and keep. When a new release is found for a monitored movie, its quality is compared against the profile to decide whether to grab it, ignore it, or treat it as an upgrade over what's already downloaded.

Profiles are reusable — you can assign the same profile to many movies, and editing the profile immediately affects all movies using it. A typical setup has two or three profiles: a "Any" profile that accepts anything, a "HD" profile targeting 1080p Bluray, and a "4K" profile targeting 2160p Remux.

Acceptable qualities

An ordered list of quality combinations that Luminarr will consider valid. Releases matching none of these are rejected outright.

Cutoff

The minimum quality Luminarr will settle for. Any movie at or above the cutoff is considered "met" — below it, Luminarr keeps searching for a better release.

Upgrade until

Luminarr stops trying to upgrade once this quality is reached. Set this to cap upgrades at, say, 1080p Bluray even if 4K is listed as acceptable.

Custom format score

Minimum score from custom format rules that a release must accumulate to be considered. Filters out releases that would score below your threshold.

Configuration

Configuration Fields

Field	Description
Name	Display name for this profile. Shown on every movie card and in library settings.
Qualities	Ordered list of acceptable quality combinations (resolution + source + codec). Releases matching any entry in this list are considered valid.
Cutoff	The specific quality that "satisfies" the profile. Movies below this quality are marked as missing or needing an upgrade in the Wanted view.
Upgrade Allowed	When enabled, Luminarr will grab a higher-quality release if one becomes available. When disabled, the first acceptable grab is kept permanently.
Upgrade Until	Only shown when Upgrade Allowed is on. The ceiling quality — Luminarr will not upgrade beyond this level. Must be equal to or higher than the cutoff.
Min Custom Format Score	Releases whose combined custom format score is below this threshold are rejected even if their quality is acceptable.
Upgrade Until CF Score	Stop upgrading via custom format score once this score is reached. Prevents endlessly re-downloading for marginal score improvements.

Upgrade Logic

How Upgrades Work

When RSS sync finds a new release for a movie that already has a file, Luminarr runs this decision sequence:

1

Is the release quality in the profile's Qualities list?

If no, the release is immediately rejected.
2

Is Upgrade Allowed enabled on the profile?

If no, no further upgrades will ever be attempted for this movie once it has a file.
3

Is the existing file's quality at or above Upgrade Until?

If yes, stop — the movie has already reached the upgrade ceiling.
4

Does the new release score higher than the existing file?

Score = resolution × 100 + source × 10 + codec. If the new release scores higher, it qualifies as an upgrade.
5

Does the release meet the Min Custom Format Score?

If the accumulated custom format score is below the threshold, the release is rejected regardless of quality score.
6

Grab the release.

The release is sent to the download client. After import, the old file is deleted if using move mode.

Score ties. If the new release scores identically to the existing file, it is not treated as an upgrade and will be skipped. This prevents re-downloading the same quality from a different source repeatedly.

Reference

Quality Ranking

Luminarr assigns numeric ranks to resolution, source, and codec. Higher rank = better quality. The final score used for upgrade comparisons is resolution × 100 + source × 10 + codec.

Resolution

Resolution	Rank	Score contribution
SD	0	0
720p	1	100
1080p	2	200
2160p	3	300

Source

Source	Rank	Score contribution
CAM	0	0
DVD	1	10
HDTV	2	20
WebRip	3	30
WebDL	4	40
Bluray	5	50
Remux	6	60

Codec

Codec	Rank	Score contribution
Unknown	0	0
XviD	1	1
x264	2	2
x265	3	3
AV1	4	4

HDR is a separate flag. Luminarr tracks HDR (HDR10, Dolby Vision, HLG, HDR10+) independently of the score formula. You can filter releases by HDR support in the quality list — it does not affect upgrade score comparisons.