Radarr Settings

Radarr Settings

---

Please note that this information is only for Radarr V3.

Media Management

Note: Some of these settings are only visible through 'show advanced' settings which is on the top bar under the search bar

---

Movie Naming

Commonly used naming schema are:

• Standard Movie Format

{Movie Title} {(Release Year)} {Edition Tags} {[Quality Full]} {[MediaInfo 3D]} {[MediaInfo VideoDynamicRange]} [{MediaInfo VideoBitDepth}bit] {[MediaInfo VideoCodec]} {[MediaInfo AudioCodec}-{MediaInfo AudioChannels]}{MediaInfo AudioLanguages}{-Release Group} 

which would then output: The Movie Title! (2010) Ultimate Extended Edition [Bluray-1080p Proper] [3D] [HDR] [10bit] [x264] [DTS-5.1][DE]-EVOLVE. This allows critical data such as the group and Quality (source) to be maintained within the file name in case of database loss or corruption

• Movie Folder Format

{Movie Title} ({Release Year}) {tmdb-{tmdbid}} {imdb-{imdbid}} which would then output: The Movie Title! (2010) {tmdb-345691} {imdb-tt0066921}

• Rename Movies - If this is toggled off (no check in the box) Radarr will use the existing file name if renaming is disabled
• Replace Illegal Characters - If this is toggled off (no check in the box) Radarr will replace illegal characters.

Example: \ # / $ * < > just to name a few

• Colon (:) Replacement - This setting will dictate how Radarr handles colons within the movie file.
  This is only available when Replace Illegal Characters is toggled on (check in the box)
  • Delete - Self explanatory
    • Example: Movie,The.mkv -> MovieThe.mkv
  • Replace with Dash - Removes the colon and adds a dash in its place
    • Example: Movie,The.mkv -> Movie-The.mkv
  • Replace with Space - Removes the colon and adds a space in its place
    • Example: Movie,The.mkv -> Movie The.mkv
  • Replace with Space Dash Space - self explanatory
    • Example: Movie,The.mkv -> Movie - The.mkv

Standard Movie Format

Here you will select the naming convention for the actual movie files

• Dropdown Box (upper right corner)
  • Left Box - Space Handling
    • Space ( ) - Use spaces in naming (Default)
    • Period (.) - Use periods in lieu of spaces in naming
    • Underscore (_) - Use underscores in lieu of spaces in naming
    • Dash (-) - Use dashes in lieu of spaces in naming
  • Right Box - Case Handling
    • Default Case - Make title uppercase and lowercase (~camelcase) (Default)
    • Uppercase - Make title all Uppercase
    • Lowercase - Make title all Lowercase

Movie Naming

Input	Result
{Movie Title}	Movie Name!
{Movie Title:DE}	FileTitle
{Movie CleanTitle}	Movie Name
{Movie TitleThe}	Movie Name, The
{Movie OriginalTitle}	Τίτλος ταινίας
{Movie TitleFirstCharacter}	M
{Movie Collection}	The Movie Collection
{Movie Certification}	PG-13
{Release Year}	2020

Movie IDs

Input	Result
{ImdbId}	tt12345
{Tmdbid}	123456

Quality (Naming)

Input	Result
{Quality Full}	HDTV 720p Proper
{Quality Title}	HDTV 720p

Media Info

Input	Result
{MediaInfo Simple}	x264 DTS
{MediaInfo Full}	x264 DTS [EN+DE]
{MediaInfo VideoCodec}	x264
{MediaInfo AudioCodec}	DTS
{MediaInfo AudioChannels}	5.1
{MediaInfo AudioLanguages}	[EN+DE]
{MediaInfo SubtitleLanguages}	[EN]
{MediaInfo VideoCodec}	x264
{MediaInfo VideoBitDepth}	8
{MediaInfo VideoDynamicRange}	HDR

Release Group

Input	Result
{Release Group}	Rls Group

Edition

Input	Result
{Edition Tags}	IMAX

Custom Formats

Input	Result
{Custom Formats}	Surround Sound x264

Original

Input	Result
{Original Title}	Movie.Title.HDTV.x264.EVOLVE
{Original Filename}	Movie.title.hdtv.x264.EVOLVE

• Original Filename is not recommended. It is the literal original filename and may be obfuscated t1i0p3s7i8yuti.
• Original Title is the release name is is what is suggested to be used.

Standard Movie Folder Format

This is where you will set the naming convention for the folder that contains the video file.

Movie Naming

Input	Result
{Movie Title}	Movie Name!
{Movie Title:DE}	Filetitle
{Movie CleanTitle}	Movie Name
{Movie TitleThe}	Movie Name, The
{Movie OriginalTitle}	Τίτλος ταινίας
{Movie TitleFirstCharacter}	M
{Movie Collection}	The Movie Collection
{Movie Certification}	PG-13
{Release Year}	2020

Movie IDs

Input	Result
{ImdbId}	tt12345
{Tmdbid}	123456

Folders

• Create Empty Media folders - This will create an empty folder during disk scan
• Delete Empty Folders - This will remove any empty folders during disk scan

Importing

• Skip Free Space Check - Use when Radarr is unable to detect free space from your movies root folder
• Minimum Free Space - Toggling this will prevent import if it would leave less than this amount of disk space available
• Use Hard links instead of Copy - Use Hard links when trying to copy files from torrents that are still being seeded (for more information on this click here)
• Import Extra Files - Import matching extra files (subtitles, nfo, etc) after importing a file

File Management

• Ignore Deleted Movies - Movies deleted from disk, detected by a scheduled or manual rescan, are automatically unmonitored in Radarr
• Download Proper & Repacks - Should Radarr automatically upgrade and preferr propers when available? (see link for explanation on Proper and Repack)
  • Prefer and Upgrade - Rank repacks and propers higher than non-repacks and non-propers. Treat new repacks and propers as upgrade to current releases.
  • Do Not Upgrade Automatically - Rank repacks and propers higher than non-repacks and non-propers. Do not treat new repacks and propers as upgrade to current releases.
  • Do Not Prefer - Effectively this ignores repacks and propers. You'll need to manage any preference for those with custom formats.
• Analyse video files - Extract file information such as resolution, runtime and codec information from files. This requires Radarr to read parts of the file which may cause high disk or network activity during scans.

• Rescan Movie Folder after Refresh
  • Always - This will rescan the movies folder based upon Tasks Schedule
  • After Manual Refresh - You will have to manually rescan the disk
  • Never - Just as it says, never rescan the movie folder.

• Change File Date
  • None - Radarr will not change the date that shows in your given file browser
  • In Cinemas - The date the video was in cinemas
  • Physical release date - The date the video was released on disc/streaming

• Recycling Bin - Designate a location for deleted files to go to (just in case you want to retrieve them before the bin is taken out)
• Recycling Bin Cleanup - This is how old a given file can be before it is deleted permanently

Permissions

• Set Permissions - This will allow Radarr to set the given file permission when a given file is imported or renamed
• chmod folder - This is the permission level that Radarr will set for a given file on import or rename (more information HERE)
  • The drop down box has a preset list of very commonly used permissions that can be used. However, you can manually enter a folder octal if you wish.
• chmod Group - This only works if the user running Radarr is the owner of the file. It's better to ensure the download client uses the same group as Radarr.

Profiles

---

Quality Profiles

• Here you'll be allowed to set profiles for which you can have for the quality of movie you're looking to download
• When selecting an existing profile or adding an additional profile a new window will appear
  Note: The quality with the blue box will be the quality that is set for Upgrade Until (basically the cutoff)
  • Name - Here you'll select a UNIQUE name for the profile to which you are creating
  • Upgrades allowed - If you tell Radarr to download a Web 1080p as it is the first release of a specific movie then later somebody is able to upload a Bluray-1080p then with this selected Radarr will automatically upgrade to the better quality
    Note: This is only if you have Bluray-1080p higher than Web 1080p within the Qualities section and both are selected
  • Upgrade until Quality - Here you'll set the cut-off to which Radarr says to its self, "This is as high of quality that you want. I won't be looking anymore for better quality releases."
  • Minimum Custom Format Score - The minimum sum of custom format(s) for a release to be downloaded. Note this does not outrank qualities, but is ranked after qualities.
  • Upgrade Until Custom Format Score - Similar to Upgrade until Quality; the minimum score to be reached within a quality to upgrade to. Once this is reached, there will be no upgrades within that quality due to custom formats.
  • Language - Select your preferred language
  • Custom Format - Radarr scores each release using the sum of scores for matching custom formats. If a new release would improve the score, at the same or better quality, then Radarr will grab it.
    • For more details on Custom Formats click HERE
  • Qualities - For definitions for qualities please click HERE
  • Edit Groups - Some qualities are grouped together to reduce the size of the list as well grouping like releases, Prime example of this is WebDL and WebRip as these are very similar and typically have similar bitrates. When editing the groups you can change the preference within each of the groups.
    • Qualities higher in the list are more preferred. Qualities within the same group are equal. Only checked qualities are wanted
      Note: By default the qualities are set from lowest (bottom) to highest (top)

Delay Profiles

• Delay profiles allow you to reduce the number of releases that will be downloaded for an Movie, by adding a delay while Radarr will continue to watch for releases that better match your preferences.
  • Protocol - This will either be Usenet or Torrent depending on which download protocol you're using
  • Usenet Delay - Set by the number of minutes you'll want to wait before the download to start
  • Torrent Delay - Set by the number of minutes you'll want to wait before the download to start
  • Bypass if Highest Quality - Bypass the delay profile if the highest quality for that Movie is found and grab once the first instance of the highest ranked quality is found. Otherwise wait for the best quality release until the end of the delay period.
  • Tags - This is where you'll select any relevant tags that you'll be using for this scheme
• Wrench icon - This will allow you to edit the delay profile
• Plus icon - Create a new profile

Example: Some media will receive half a dozen different releases of varying quality in the hours after a release, and without delay profiles Radarr might try to download all of them. With delay profiles, Radarr can be configured to ignore the first few hours of releases.

Delay profiles are also helpful if you want to emphasize one protocol (Usenet or BitTorrent) over the other. (See Example 3)

How Delay Profiles Work

The timer begins as soon as Radarr detects an Movie has a release available. This release will show up in your Queue with a clock icon to indicate that it is under a delay. Please note that the clock starts from the releases uploaded time and not from the time Radarr sees it.

During the delay period, any new releases that become available will be noted by Radarr. When the delay timer expires, Radarr will download the single release which best matches your quality preferences.

The timer period can be different for Usenet and Torrents. Each profile can be associated with one or more tags to allow you to customize which shows have which profiles. A delay profile with no tag is considered the default and applies to all shows that do not have a specific tag.

NOTE: Delay profiles start from the timestamp that the indexer reports the release was uploaded. This means that any content older than the number of minutes you have set are not impacted in any way by your delay profile, and will be downloaded immediately. In addition, any manual searches for content (non-RSS feed searches) will ignore delay profile settings.

Examples

For each example, assume the user has the follow quality profile active: HDTV 720p and above are allowed WebDL 720p is the quality cutoff * WebDL 1080p is the highest ranked quality

Example 1:

In this simple example, the profile is set with a 120 minute (two hour) delay for both Usenet and Torrent.

At 11:00pm the first release for an Movie is detected by Radarr and it was uploaded at 10:50pm and the 120 minute clock begins. At 12:50am, Radarr will evaluate any releases it has found in the past two hours, and download the best one, which is WebDL 720p.

At 3:00am another release is found, which is WebDL 720p that was added to your indexer at 2:46am. Another 120 minute clock begins. At 4:46am the best-available release is downloaded. Since the quality cutoff is now reached, the Movie no longer is upgradable and Radarr will stop looking for new releases.

At any point, if a WebDL 1080p release is found, it will be downloaded immediately because it is the highest-ranking quality. If there is a delay timer currently active it will be cancelled.

Example 2:

This example has different timers for Usenet and Torrents. Assume a 120 minute timer for Usenet and a 180 minute timer for BitTorrent.

At 11:00pm the first release for an Movie is detected by Radarr and both timers begin. The release was added to the indexer at 10:15pm At 12:15am, Radarr will evaluate any releases, and if there are any acceptable Usenet releases, the best one will be downloaded and both timers will end. If not, Radarr will wait until 12:15am and download the best release, regardless of which source it came from.

Example 3:

A common use for delay profiles is to emphasize one protocol over another. For example, you might only want to download a BitTorrent release if nothing has been uploaded to Usenet after a certain amount of time.

You could set a 60 minute timer for BitTorrent, and a 0 minute timer for Usenet.

If the first release that is detected is from Usenet, Radarr will download it immediately.

If the first release is from BitTorrent, Radarr will set a 60 minute timer. If any qualifying Usenet release is detected during that timer, the BitTorrent release will be ignored and the Usenet release will be grabbed.

Quality

---

Quality Table Meanings

• Title - The name of the Quality in the GUI (configurable)
• Max - The maximum Megabytes per Minute (MB/min) a quality can have.
• Megabytes Per Minute - Self Explanatory
• Min - The minimum Megabytes per Minute (MB/min) a quality can have.
• Preferred - The preferred Megabytes per Minute (MB/min) a quality can have.
• Quality - The scene quality name (hardcoded)
• Size Limit - Self Explanatory

Qualities Defined

• Unknown - Self Explanatory

• WORKPRINT - A workprint of a film generally contains timecode and usually has watermarks from the studio involved in the production of the film. These "proxy" copies of a film often go between the editorial and visual effects departments of the film crew. A workprint may be of any resolution, but are generally lower quality versions of the film used to show progress on the editorial or post-production process. Therefore, these may not be at all the same as a theatrical version of the film, and may be missing many of the visual effects or audio that end up making it to the theatrical release.

• CAM - is a theater rip usually done with a digital video camera. A mini tripod is sometimes used, but a lot of the time this won't be feasible, so the camera may shake. Seating placement isn't always ideal, and it might be filmed from an awkward angle. If cropped properly, this is hard to tell unless there's text on the screen, but a lot of times these are left with triangular borders on the top and bottom of the screen. Sound is taken from the onboard microphone of the camera, and especially in comedies, laughter can often be heard during the film. Due to these factors picture and sound quality are usually quite poor, but sometimes we're lucky, and the theater will be fairly empty and a fairly clear signal will be heard.

• TELESYNC - is the same spec as a CAM except it uses an external audio source (most likely an audio jack in the chair for the disabled). A direct audio source does not guarantee good quality audio, as a lot of background noise can interfere. Sometimes a telesync is filmed in an empty cinema or from the projection booth with a professional camera, giving better picture quality. Quality ranges drastically. A high percentage of telesyncs are CAMs that have been mislabeled.

• TELECINE - A telecine machine copies the film digitally from the reels. Sound and picture should be very good, but due to the equipment and cost involved telecines are fairly uncommon. Generally, the film will be in correct aspect ratio, although 4:3 telecines have existed. TC should not be confused with TimeCode, which is a visible counter on screen throughout the film.

• REGIONAL - <--------------------- Needs definition

• DVDSCR - A pre-release DVD often sent to awards judges and various other places for promotional use. A screener is supplied on a DVD or other large enough media. The main draw back is a “ticker” (a message that scrolls past at the bottom of the screen, with the copyright and anti-copy telephone number). Also, if the screener contains any serial numbers, or any other markings that could lead to the source of the tape, these will have to be blocked, usually with a black mark over the section. This is sometimes only for a few seconds, but unfortunately on some copies this will last for the entire film, and some can be quite big. Depending on the equipment used, screener quality can range from excellent to very poor. Usually transferred to SVCD, DivX/XviD, or MP4.

• SDTV - Post air rips from an analog source (usually cable television or OTA standard definition). The image quality is generally good (for the resolution) and they are usually encoded in DivX/XviD or MP4.

• DVD - A re-encode of the final released DVD9. If possible this is released PRE retail. It should be excellent quality (for the resolution). DVDrips are usually released in DivX/XviD or MP4.

• DVD-R - Same as DVD, but re-compressed to fit a single-layer DVD (generally reduces the original source bitrate by half, so the source material may have already been compressed from the original DVD copy and has been compressed a third time by the ripper).

• WEBDL-480p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 480p (SD) quality.

• WEBRip-480p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 480p (SD) quality.

• Bluray-480p - A re-encode of the final released Blu-ray, downscaled to 480p resolution (720x480 @ 16:9, any other Aspect Ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality for the resolution. Bitrates may vary, but these are generally encoded to DivX, XviD, or AVC and offer the tradeoff of a small perceived quality reduction over the original source while drastically reducing filesize. These are generally MKV or MP4, but some DivX/XviD are around as well which use AVI.

• Bluray-576p - Same as Bluray-480p, but in 576p (720x576). 576p is the standard PAL resolution for SDTV (although some manufacturers represent HDTV as anything above 480p, 576p offers barely any perceived quality increase over 480p). Bitrates may vary, but these are generally encoded to AVC or HEVC and offer the tradeoff of a small perceived quality reduction over the original source while drastically reducing filesize. These are generally MKV or MP4 container.

• HDTV-720p - A re-encode of the final released Blu-ray, but broadcast over HD cable or satellite (1280x720 @ 16:9, any other aspect ratio may be a different resolution). It may be modified for runtime or content depending on the network it came from. This is released usually several months after a retail release, but sometimes upscaled versions of a Standard Definition film are released on cable channels such as STARZ or HBO, and they would be the only HD copies of that specific film available. These are generally MKV or MP4.

• WEBDL-720p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 720p quality.

• WEBRip-720p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 720p quality.

• Bluray-720p - A re-encode of the final released Blu-ray, downscaled to 720p resolution (1280x720 @ 16:9, any other aspect ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality for the resolution. Bitrates may vary, but these are generally encoded to AVC or HEVC and offer the tradeoff of a small perceived quality reduction over the original source while drastically reducing filesize. These are generally MKV or MP4 container.

• HDTV-1080p - A re-encode of the final released Blu-ray, but broadcast over HD cable or satellite (1920x1080 @ 16:9, any other aspect ratio may be a different resolution). It may be modified for runtime or content depending on the network it came from. This is released usually several months after a retail release, but sometimes upscaled versions of a Standard Definition film are released on cable channels such as STARZ or HBO, and they would be the only HD copies of that specific film available. These are generally MKV or MP4 container.

• WEBDL-1080p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 1080p quality.

• WEBRip-1080p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 1080p quality.

• Bluray-1080p - A re-encode of the final released Blu-ray, at its native 1080p resolution (1920x1080 @ 16:9, any other aspect ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality and the same resolution as the source. Bitrates may vary, but these are generally encoded to AVC or HEVC and offer the tradeoff of a small perceived quality reduction over the original source while slightly reducing filesize. These are generally MKV or MP4 container.

• Remux-1080p - A remux is a rip of a Blu-ray or HD DVD disc to another container format or just stripping the disc of menus and bonus material while keeping the contents of its audio and video streams intact (also keeping the current codecs), guaranteeing the exact 1:1 movie quality as on original disc. This is at 1080p quality.

• HDTV-2160p - TVRip is a capture source from an capture card. HDTV stands for captured source from HD television. With an HDTV source, the quality can sometimes even surpass DVD. Movies in this format are starting to grow in popularity. Some advertisement and commercial banner can be seen on some releases during playback. This is at 2160p (4K) quality.

• WEBDL-2160p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 2160p (4K) quality.

• WEBRip-2160p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 2160p (4k) quality.

• Bluray-2160p - A re-encode of the final released Blu-ray, at its native 2160p resolution (3840x2160 @ 16:9, any other aspect ratio may be a different resolution). 4K versions of films that are released in generally HEVC codec and could be either 8-bit or 10-bit color reproduction or from an HDR source. slightly reducing filesize. These are generally MKV or MP4 container.

• Remux-2160p - A remux is a rip of a Blu-ray or HD DVD disc to another container format or just stripping the disc of menus and bonus material while keeping the contents of its audio and video streams intact (also keeping the current codecs), guaranteeing the exact 1:1 movie quality as on original disc. This is at 2160p (4K) quality.

• BR-DISK - The original Blu-ray disc, with it's AVC/HEVC folder structure and no change in container format. Some media players are unable to deal with these, but they are generally used for archival purposes. The original Blu-ray disc content is unmodified. Most of the time, these have been run through an HDCP decryption process already via the ripper. Sometimes they are still encrypted.

Custom Formats

Custom Formats

Ensure you get the right release every time! Custom formats allows fine control over release prioritization and selection. As simple as a single preferred word or as complex as you want with multiple criteria and regex.

Custom formats have been reworked significantly in Radarr V3. They are now calculated on-the-fly instead of being stored in the database, so they update as soon as you change the definitions.

Custom formats are used within your Quality Profiles to determine the scoring of each custom format. Within each quality profile, you can set a minimum custom format score for a release to be grabbed and an upgrade until score as well.

• Name - The Name of the Custom Format
• Include Custom Format when Renaming - Include the Name of the Custom Format in Renaming; See also the naming schema.

Conditions

All conditions have two possible modifiers:

• Negate - the match is inverted, so the condition is satisfied if and only if the non-negated condition is not satisfied
• Required - only applies to formats with more than one condition of the same type and changes the matching rules for type groups. Enabling this option means that this specific condition must be satisfied for the whole custom format to apply regardless of if another condition of the same type would otherwise satisfy the type group. Note: You only use this if you use a condition more than once.

The conditions are:

• Release Title - This is a regular expression matched against the release title and, after download, the filename on disk. (Note: Radarr only considers text after the movie title and year which means anything preceding the title is ignored.)
• Edition - This tag is matched against any Editions Radarr may parse. You can put any value Radarr will try to match that against what it parsed (case-insensitive).
• Language - This language is matched against any language(s) Radarr parses. All languages previously selectable in profiles work here.
• Indexer Flag - This tag is matched against any Indexer Flags that Radarr may parse.
• Source - The source where a release was ripped from (e.g. BLURAY).
• Resolution - The resolution parsed from either the release name or mediainfo (if available).
• Quality Modifier - Quality Modifier sets things like Telescene, Telesync, Remux, Regional. It disambiguates a given source and resolution pair when there are multiple quality (source) types that can apply.
• Size - This is matched against the release size. The release size is converted to gigabytes and compared against the min and max values.

Profiling Settings and Ranking

Custom formats are implemented within and have their impact controlled by Quality Profiles. The Upgrade Until score prevents upgrading once a release with this desired score has been downloaded. A score of 0 results in the custom format being informational only. The Minimum score requires releases to reach this threshold otherwise they will be rejected. Custom formats that match with undesirable attributes should be given a negative score to lower their appeal. Outright rejections should be given a negative score low enough that even if all of the other formats with positive scores were added, the score would still fall below the minimum.

Importing/Exporting Custom Formats

Please see TRaSH's Guides for a guide. However, one is able to import and export custom formats.

Community Custom Formats

• Please see our Radarr Tips and Tricks section

Indexers

---

Once you're here you'll be adding the indexer/tracker that you'll be using to actually download any of your files. If you're curious on how Radarr works with your indexer/tracker click here

Options

• Minimum Age - Usenet only: Minimum age in minutes of NZBs before they are grabbed. Use this to give new releases time to propagate to your usenet provider.
• Retention - Usenet only: Set to zero to set for unlimited retention
• Maximum Size - Maximum size for a release to be grabbed in MB. Set to zero to set to unlimited
• Prefer Indexer Flag - If enabled, prioritize releases with special flags
  • See Indexer Flags for more details
• Availability Delay - Amount of time before (-#) or after (#) the available date to search for Movie
  • This is helpful to delay searching for a release to give the community time to perform the best encodes
• RSS Sync Interval - Interval in minutes. Set to zero to disable (this will stop all automatic release grabbing) Minimum: 10 minutes Maximum: 120 minutes
  • Please see How does Radarr work? for a better understanding of how RSS Sync will help you
  • Note: If Radarr has been offline for an extended period of time, Radarr will attempt to page back to find the last release it processed in an attempt to avoid missing a release. As long as your indexer supports paging and it hasn’t been too long will be able to process the releases it would have missed and avoid you needing to perform a search for the missed releases.
• Whitelisted Subtitle Tags - Subtitle tags set here will not be considered hardcoded
• Allow Hardcoded Subs - If enabled, detected hardcoded subs will be automatically downloaded

Restrictions

• Here you'll be able to set global restrictions based upon a couple of parameters
• Click the + and a new window will open
  • Must Contain - Within this field you can tell Radarr that if a release does not contain a certain string then Radarr will not grab that release. This is case insensitive by default and regex can be used.
  • Must Not Contain - Within this field you can tell Radarr that if a release does contain a certain string then Radarr will not grab that release. This is case insensitive by default and regex can be used.
  • Tags - Here you can apply these settings to movies with at least one of the given tag
    • Please see Tags

Download Clients

---

Overview

Downloading and importing is where most people experience issues. From a high level perspective, the software needs to be able to communicate with your download client and have access to the files it downloads. There is a large variety of supported download clients and an even bigger variety of setups. This means that while there are some common setups there isn't one right setup and everyone's setup can be a little different. But there are many wrong setups.

Completed Download Handling

Completed Download Handling is how Radarr imports media from your download client to your series folders. Many common issues are related to bad Docker paths and/or other Docker permissions issues.

• Enable - Automatically import completed downloads from the download client
• Remove - Remove completed downloads when finished (usenet) or stopped/complete (torrents)
• Check For Finished Downloads Interval - How often to query the download client

Remove Completed Downloads

1. Radarr will send a download request to your client, and associate it with a label or category name that you have configured in the download client settings.
2. Radarr will monitor your download clients active downloads that use that category name. It monitors this via your download client's API.
3. When the download is completed, Radarr will know the final file location as reported by your download client. This file location can be almost anywhere, as long as it is somewhere separate from your media folder.
4. Radarr will scan that completed file location for video files. It will parse the video file name to match it to a movie. If it can do that, it will rename the file according to your specifications, and move it to the assigned library folder.
5. Leftover files from the download will be sent to your trash or recycling.

If you download using a BitTorrent client, the process is slightly different:

• Completed files are left in their original location to allow you to seed. When files are imported to your assigned library folder Radarr will attempt to hardlink the file or fall back to copy (use double space) if hard links are not supported.
• If the "Completed Download Handling - Remove" option is enabled in settings, Radarr will delete the original file and torrent from your client, but only if the client reports that seeding is complete and torrent is stopped.

Remote Path Mappings

Remote Path Mapping acts as a dumb find Remote Path and replace with Local Path This is primarily used for either merged local/remote setups using mergerfs or similar or is used for when the application and download client are not on the same server.

One of our amazing community members have created an excellent guide to help you out if you think remotte path mapping is what will work for you here

Lists

---

Lists

Lists are a part of Radarr that allow you to follow a given list creator. Let's say that you follow a given list creator on Trakt/TMDb and really like their Marvel Cinematic Universe film section and want to watch every movie on their list. You look in your Radarr and realize that you don't have those movies. Well instead of searching one by one and adding those items and then searching your indexers for those movies. You can do this all at once with a List. The Lists can be set to import all the movies on that curator's list as well as be set to automatically assign a quality profile, automatically add, and automatically monitor that movie.

CAUTION: If lists are done improperly they will absolutely wreck your library with a bunch of trash you have no intention of watching. So make sure of what you're importing before you click save. ie. physically look at the list before you even go to Radarr.

• Here you can select the + button to open a new pop up window
  • From this new window you are presented with many different options to set up your list from many different list providers. As stated before be careful when doing lists. It is highly recommended to not select the Search on add button before you're absolutely sure the list you select/setup is adding the movies that you're looking for.
  • Once you've selected the list provider that you're looking to pull from (such as IMDb, IMDb, Trakt) You'll be presented with a new window.
    • Most of the lists settings are fairly self explanatory, some lists require you to authenticate with the provider such as Trakt (requiring you to have an account with Trakt.tv

Options

From the Options setting you'll be presented with settings such as

• List Update Interval - From here you'll be able to select how often you'd like Radarr to scan for any updates to the lists that you're following
• Clean Library Level - Movies in library will be removed or unmonitored if not in your list. This setting is so that if a movie is in your current library and you enable this. All movies other than this list will do what ever option is selected

List Exclusions

• List Exclusion - This allows you to prune your list of movies you don't want to see again. An example of this is if your list just so happens to contain a movie that is in a foreign language and it is not likely for you to ever find this movie in your native language and do not want to watch it with subtitles. You can exclude a movie from being added in the future. However, in the list exclusion section you can add it back to the list so that when the list runs again it will be readded to your library.

Connect

---

Connections

Connections are how you want Radarr to communicate with the outside world.

• By pressing the + button you'll be presented with a new window which will allow you to configure many different endpoints
  • There are many different endpoints
    • Boxcar
    • Custom Scripts - This allows you to make a custom script for when a particular action happens this script will run
    • Discord - By far one of the most common ways to push notifications of actions happening on your Radarr
    • Notifiarr - The brainchild of one of the Radarr developers allowing you to have beautiful discord notifications with very fine tuned control. Constantly being updated and a favorite amongst many of the Radarr team.
    • Email - Simply send yourself or somebody you want to annoy with email. If you're using Gmail, you need to enable less secure apps. If you're using Gmail and have 2-factor authentication enabled you need to use an App Specific password.
      • You can use a "pretty address" like SomePrettyName <email@example.org>
    • Emby
    • Gotify
    • Join
    • Kodi - Kodi spawned from the love of media. It is an entertainment hub that brings all your digital media together into a beautiful and user friendly package. It is 100% free and open source, very customisable and runs on a wide variety of devices. It is supported by a dedicated team of volunteers and a huge community.
      • By adding Kodi as a connection you can update Kodi's library when a new movie has been added to Radarr
    • Plex Media Server - The server for your self hosted Plex system, Enabling this is much like Kodi will allow you to push an update to your plex server notifying it that a new/upgraded movie is available
    • Prowl
    • Pushbullet
    • Pushover
    • Sendgrid
    • Slack
    • Synology Indexer
    • Telegram
    • Trakt
    • Twitter
      • Create a Twitter application (if you haven’t already) at https://apps.twitter.com/
      • Fill in the mandatory fields as well as the callback URL, set it to a publicly available URL (not localhost), it doesn’t need to exist, but it does need to be set, using https://radarr.video/twitter is sufficient.

• Connection Triggers
  • On Grab - Be notified when movies are available for download and has been sent to a download client
  • On Import - Be notified when movies are successfully imported
  • On Upgrade - Be notified when movies are upgraded to a better quality
  • On Rename - Be notified when movies are renamed
  • On Movie Delete - Be notified when movies are deleted
  • On Movie File Delete - Be notified when movie files files are deleted
  • On Movie File Delete For Upgrade - Be notified when movie files are deleted for upgrades
  • On Health Issue - Be notified on health check failures
  • Include Health Warnings - Be notified on health warnings in addition to errors.

Metadata

---

Metadata

• Certification Country - Here you can select the country to which the certifications for the movies in your library are associated to.
  • MPA Film rating
  • BBFC

Options

Here you can select the type of metadata that will be consumed by your media player

• Kodi will be one of the most commonly used options here if that is the software that is being used. This will allow Radarr to create a NFO file as well as associated movie posters to be scraped into your player

Tags

---

• The tag section is for Radarr is simply used to see what tags you have used and what movies have that tag associated to it.
• Tags can be useful to limit certain aspects of Radarr to a specific movie

General

---

Host

• Binding Address - Valid IP4 address or '*' for all interfaces
  • 0.0.0.0 or * - any address can connect
  • 127.0.0.1 or localhost - only localhost applications can connect
  • Any other IP (e.g. 1.2.3.4) - only that IP (1.2.3.4) can connect
• Port Number - The port number that you are wanting to use to access the webUI for Radarr
  • Note: If using Docker do not touch
• URL Base - For reverse proxy support, default is empty
  • Note: If using a reverse proxy (example: mydomain.com/radarr) you would enter '/radarr' for URL Base.
• Enable SSL - If you have SSL credentials and would like to secure communication to and from your Radarr enable this option.
  • Note: do not mess with unless you know what you're doing

Security

• Authentication - How would you like to authenticate to access your Radarr instance
  • None - You have no authentication to access your Radarr
    • Typically if you're the only user of your network, do not have anybody on your network that would care to access your Radarr or your Radarr is not exposed to the web
  • Basic (Browser pop-up) - This option when accessing your Radarr will show a small pop-up allowing you to input a Username and Password
  • Forms (Login Page) - This option will have a familiar looking login screen much like other websites have to allow you to log onto your Radarr
• API Key - This is how other programs would communicate or have Radarr communicate to other programs. This key if given to the wrong person with access could do all kinds of things to your library. This is why in the logs the API key is redacted
• Certificate Validation - Change how strict HTTPS certification validation is

Proxy

• Proxy - This option allows you to run the information your Radarr pulls and searches for through a proxy. This can be useful if you're in a country that does not allow the downloading of Torrent files

Logging

• Log level - Probably one of the most useful troubleshooting tools
  • Info - This is the most basic way that Radarr gathers information this will include very minimal amount of information in the logs.
    • This log file contains fatal, error, warn and info entries.
  • Debug - Debug will include all the information that Info includes plus more information that can be useful.
    • This log files contains fatal, error, warn, info and debug entries
  • Trace - The most advance and detailed logging on Radarr, Trace will include all the information gathered by Info and Debug and more. This is the most common type of log that is going to be asked for when troubleshooting on Discord or Reddit. If you're needing help please select your log to Trace and redo the task that was giving you problems to capture the log.
    • This log files contains fatal, error, warn, info, debug and trace entries.

Analytics

• Analytics - Send anonymous usage and error information to Radarr's servers (Servarr). This includes information on your browser, which Radarr WebUI pages you use, error reporting as well as OS and runtime version. We will use this information to prioritize features and bug fixes.

Updates

See Also: FAQ: How do I update Radarr?

• Branch - This is the branch of Radarr that you are running on. Please see the FAQ for available branches and version information
• Automatic - Automatically download and install updates. You will still be able to install from System: Updates. Note: Windows Users are always automatically updated.
• Mechanism - Use Radarr's built-in updater or a script
  • Built-In - Use Radarr's own updater
  • Docker - Do not update Radarr from inside the Docker, instead pull a brand new image with the new update
  • Script - Have Radarr run the update script

Backups

The backup section allows you to tell Radarr how you would like for it to handle backups

• Folder - This allows you to select the backup location
  • In docker you will be limited to what you allow the container to see
  • Paths are relative to the appdata folder; if necessary, you can set an absolute path to backup outside of the appdata folder
• Interval - How often would you like Radarr to make a backup
• Retention - How long would you like Radarr to hold on to each backup. After a new backup is made the oldest backup will be removed

UI

Calendar

In this section you can manipulate some features of the calendar

• First Day of Week - Here you can select what you think the first day of the week should be.
• Week Column Header - Here you can select the header for the columns

Movies

• Runtime Format - Do you want the runtime to be in HH:MM or MM?

Dates

• Short Date Format - How do you want Radarr to display short dates?
• Long Date Format - How do you want Radarr to display long format dates?
• Time Format - Do you want a 12hr or 24hr format?
• Show Relative Dates - Do you want Radarr to show relative (Today/Yesterday/etc) or absolute dates?

Style

• Enable Color-Impaired Mode - Altered style to allow color-impaired users to better distinguish color coded information

Language

• Movie Info Language - What language is Radarr going to use for Movie Information in UI?
• UI Language - What language will Radarr use for the UI?