WARNING
Under construction blue.png Please note that this site is still under heavy construction.

Lidarr Settings


Media Management

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


Naming

  • Rename Movies - If this is toggled off (no check in the box) Lidarr will use the existing file name if renaming is disabled
  • Replace Illegal Characters - If this is toggled off (no check in the box) Lidarr will replace illegal characters.
Example: \ # / $ * < > just to name a few
Standard Track Format

Here you will select the naming convention for the actual audio 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 upper and lower Case (~camelcase) (Default)
      • Upper Case - Make title all upper case
      • Lower Case - Make title all lower case
Artist Naming
Input Result
{Artist Name} Artist Name
{Artist CleanName} Artist Name
{Artist NameThe} Artist Name, The
{Artist Disambiguation} Disambiguation
Album
Input Result
{Album Title} Album Title
{Album CleanTitle} Album Title
{Album Disambiguation} Disambiguation
{Album TitleThe} Abume Title, The
{Album Type} Album Type
Release Date
Input Result
{Release Year} 2020
Medium
Input Result
{medium:0} 1
{medium:00} 01
Medium Format
Input Result
{Medium Format} CD
Track
Input Result
{track:0} 1
{track:00} 01
Track Title
Input Result
{Track Title} Track Title
{Track CleanTitle} Track Title
Quality
Input Result
{Quality Full} FLAC Proper
{Quality Title} FLAC
Media Info
Input Result
{MediaInfo AudioCodec} FLAC
{MediaInfo AudioBitRate} 320kbps
{MediaInfo AudioSampleRate} 44.1kHz
{MediaInfo AudioChannels} 2.0
{MediaInfo AudioBitsPerSample} 24bit
Other
Input Result
{Release Group} Rls Grp
{Preferred Words} iNTERNAL
Original
Input Result
{Original Title} Artist.Name.Album.Name.2020.FLAC.EVOLVE
{Original Filename} 01-track name
Multi Disc Track Format

See Standard Track Format

Artist Folder Format
Input Result
{Artist Name} Artist Name
{Artist CleanName} Artist Name
{Artist NameThe} Artist Name, The
{Artist Disambiguation} Disambiguation
Album Folder Format
Artist
Input Result
{Artist Name} Artist Name
{Artist CleanName} Artist Name
{Artist NameThe} Artist Name, The
{Artist Disambiguation} Disambiguation
Album
Input Result
{Album Title} Album Title
{Album CleanTitle} Album Title
{Artist Disambiguation} Disambiguation
{Album TitleThe} Album Title, The
{Album Type} Album Type
Release Date
Input Result
{Release Year} 2020


Folders

Only visible with advanced toggled

  • 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 Lidarr is unable to detect free space from your aritist root folder
  • Use Hardlinks instead of Copy - Use Hardlinks when trying to copy files from torrents that are still being seeded (for more information on this click HERE)
Only visible with advanced toggled
  • Import Extra Files - Import matching extra files (subtitles, nfo, etc) after importing a file


File Management

  • Ignore Deleted Tracks - Tracks deleted from disk are automatically unmonitored in Lidarr
  • Download Proper & Repacks - Should Lidarr automatically upgrade to propers when available? (see link for explanation on Proper and Repack)
    • Prefer and Upgrade - will prefer proper/repack if one is available (gives it a higher rating)
    • Do not upgrade automatically - This will not allow it to upgrade automatically but will still be rated accordingly.
  • Rescan Aritst Folder after Refresh
    • Always - This will rescan artist folder based upon Tasks Schedule
    • After Manual Refresh - You will have to manually rescanning the disk
    • Never - Just as it says, NEVER
  • Allow Fingerprinting - Use fingerprinting to improve accuracy of track matching
    • Always - This will analyze the file when matching
    • For New Imports Only - This will analyze only new imports
    • Never - just as it says, NEVER
  • Change File Date
    • None - Lidarr will not change the date that shows in your given file browser
    • Album Release Date - The date the album was released
  • 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 Lidarr to set the given file permission when a given file is imported or renamed
  • File chmod mode - This is the permission level that Lidarr will set for a given file on import or rename (more information HERE)


Root Folders

  • Path - This shows the path to your media
  • Free Space - This is the free space being reported to Radarr from the system
  • Unmapped Folders - ??
  • The X at the end - This will remove this given root path
  • Add folder - This allows you to select a root path for a place to either place new downloads into this folder or to allow Radarr to scan existing media


Profiles


Quality Profiles

  • Here you'll be allowed to set profiles for which you can have for the quality of series 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 green 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 Lidarr to download a MP3-160 (Poor Quality Lossy) file as it is the first release of a specific episode then later somebody is able to upload a FLAC (Lossless) then with this selected Lidarr will automatically upgrade to the better quality
      Note: This is only if you have FLAC (Lossless) higher than MP3-160 (Poor Quality Lossy) within the Qualities section
    • 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 MP3-160 and MP-96 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)


Metadata Profiles

  • Here you'll be allowed to set profiles for which you can have for the releases of a given artist
  • When selecting an existing profile or adding an additional profile a new window will appear
    • Name - Here you'll select a UNIQUE name for the profile to which you are creating
    • Primary Types - These are typically the most common types of releases from an artist
    • Secondary Types - Less common types of releases however some artists will have them
    • Release Statuses - How did the artist release their material?

Note: If you're not seeing a release from a given artist then you might then you might want to create more profiles. A prime example of this is Metallica. They have 10 primary Album releases that show up under the "Standard" profile, however, if you're looking for S&M. Then you'll need to ensure that EP is selected in order to see it. Note: Be careful with with selecting everything long running artists or artists with a lot of different types of releases can make loading up a specific artist for the first time quite slow as Lidarr is pulling all the information down an example of this is if you select everything for Metallica over 600 album releases are pulled as possible downloads


Delay Profiles

  • Delay profiles allow you to reduce the number of releases that will be downloaded for an Track, by adding a delay while Lidarr 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
    • 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 Lidarr might try to download all of them. With delay profiles, Lidarr 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 Lidarr detects an Track has a release available. This release will show up in your Queue with a clock icon to indicate that it is under a delay.

During the delay period, any new releases that become available will be noted by Lidarr. When the delay timer expires, Lidarr 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.

Examples

For each example, assume the user has the follow quality profile active: MP3-320 and above are allowed OGG Vorbis Q7 is the quality cutoff * FLAC 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 Track is detected by Lidarr and the 120 minute clock begins. At 1:00am, Lidarr will evaluate any releases it has found in the past two hours, and download the best one, which is OGG Vorbis Q7.

At 3:00am another release is found, which is OGG Vorbis Q7. Another 120 minute clock begins. At 5:00am the best-available release is downloaded. Since the cutoff is now reached, the Track no longer monitored and Lidarr will stop looking for new releases.

At any point, if a FLAC 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 Track is detected by Lidarr and both timers begin. At 1:00am, Lidarr 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, Lidarr will wait until 2:00am 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, Lidarr will download it immediately.

If the first release is from BitTorrent, Lidarr 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.

Release Profiles

  • Not all releases are created equal, each release group has their own way of packaging and encoding their material. Here you'll be able to select the preferred releases you're looking for
  • Enable Profile - Toggling this given profile on or off
  • Must Contain - The release must contain at least one of these terms (case insensitive)
  • Must Not Contain - The release will be rejected if it contains one or more of terms (case insensitive)
  • Preferred - Here you can select a given term and give it a score.
  • Include Preferred when Renaming - When utilizing the {Preferred Words} tag in the naming scheme
  • Tags - With giving this release profile a tag you'll be able to tag a given series to have it play by the rules set here. If you leave this field blank these rules will apply to all series


Quality


Quality Table Meanings

  • Title - The name of the Quality in the GUI (configurable)
  • Max - The maximum Kilobytes per second (KB/s) a quality can have.
  • Kilobytes Per Second - Self Explanatory
  • Min - The minimum Kilobytes per second (KB/s) a quality can have.
  • Preferred - The preferred Kilobytes per second (KB/s) a quality can have.
  • Quality - The scene quality name (hardcoded)
  • Size Limit - Self Explanatory


Quality Definitions

  • AAC-192 - An AAC file with a 192 kbps bitrate
  • AAC-256 - An AAC file with a 256 kbps bitrate
  • AAC-320 - An AAC file with a 320 kbps bitrate
  • AAC-VBR - An AAC file with a variable bitrate
  • ALAC - Audio file created with the Apple Lossless Audio Codec (ALAC); used for storing digital music losslessly without losing any sound quality from the original audio data; differs from lossy audio codecs such as AAC.
  • APE - Audio file compressed using Monkey's Audio lossless compression algorithm; includes error detection and support for tags that store information about audio files; sometimes created with .CUE files to comprise an audio CD image.
  • FLAC - A FLAC file is an audio file compressed in the Free Lossless Audio Codec (FLAC) format, which is an open source lossless audio compression format. It is similar to a .MP3 file, but is compressed without any loss in quality or loss of any original audio data.
  • FLAC 24bit - A FLAC file with 24-bit encoding, allowing a much wider dynamic range than CD, and sampling rates all the way up to 192kHz
  • MP3-8 - A MP3 file with a 8 kbps bitrate
  • MP3-16 - A MP3 file with a 16 kbps bitrate
  • MP3-24 - A MP3 file with a 24 kbps bitrate
  • MP3-32 - A MP3 file with a 32 kbps bitrate
  • MP3-40 - A MP3 file with a 40 kbps bitrate
  • MP3-48 - A MP3 file with a 48 kbps bitrate
  • MP3-56 - A MP3 file with a 56 kbps bitrate
  • MP3-64 - A MP3 file with a 64 kbps bitrate
  • MP3-80 - A MP3 file with a 80 kbps bitrate
  • MP3-96 - A MP3 file with a 96 kbps bitrate
  • MP3-112 - A MP3 file with a 112 kbps bitrate
  • MP3-128 - A MP3 file with a 128 kbps bitrate
  • MP3-160 - A MP3 file with a 160 kbps bitrate
  • MP3-192 - A MP3 file with a 192 kbps bitrate
  • MP3-224 - A MP3 file with a 224 kbps bitrate
  • MP3-256 - A MP3 file with a 256 kbps bitrate
  • MP3-320 - An MP3 file with a 320 kbps bitrate
  • MP3-VBR-V0 - An MP3 file with a variable bitrate (version 0)
  • MP3-VBR-V2 - An MP3 file with a variable bitrate (version 2)
  • OGG Vorbis Q5 - An OOG file with an 160 kbps bitrate
  • OGG Vorbis Q6 - An OOG file with a 192 kbps bitrate
  • OGG Vorbis Q7 - An OOG file with a 224 kbps bitrate
  • OGG Vorbis Q8 - An OOG file with a 256 kbps bitrate
  • OGG Vorbis Q9 - An OOG file with a 320 kbps bitrate
  • OGG Vorbis Q10 - An OOG file with a 500 kbps bitrate
  • Unknown - Self Explanatory
  • WavPack - WavPack compresses high-quality audio to between thirty and seventy percent and supports both mono and stereo audio ranging from 8 to 32 bits. Typically these are audio files in an .WV container
  • WAV - A WAV file is an audio file saved in the WAVE format, which is a standard digital audio file format utilized for storing waveform data. WAV files may contain audio recordings with different sampling rates and bitrates but are often saved in a 44.1 KHz, 16-bit, stereo format, which is the standard format used for CD audio.
  • WMA - A WMA file is an audio file saved in the Advanced Systems Format (ASF) proprietary format developed by Microsoft. It contains Windows Media Audio and metadata objects such as the title, artist, album, and genre of the track. WMA files are similar to .MP3 files and primarily used for streaming music from the web.


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 Lidarr works with your indexer/tracker click HERE

Indexers

Once you've clicked the + button to add a new indexer you'll be presented with a new window with many different options. For the purposes of this wiki Lidarr considers both Usenet Indexers and Torrent Trackers as "Indexers".

There are two sections here: Usenet and Torrents. Based upon what download client you'll be using you'll want to select the type of indexer you'll be going with.

More information on Indexers and Trackers can be found HERE


Usenet:

  • Newsznab - Here you'll find presets of popular usenet indexers (that are pre-filled out, all you'll need is your API key which is provided by the usenet indexer of your choice) along with the ability to create a custom Indexer
    • Regardless of if you select a pre filled out indexer or a custom indexer setup you'll be presented with a new window to input all your settings
    • Name - This is where you'll select a unique name - typically you'd want to put the indexer name that you're using
    • Enable RSS - Enable this indexer for monitoring the RSS feed for new future releases
    • Enable Automatic Search - Enable this indexer for when you trigger an automatic search or have Lidarr search
    • Enable Interactive Search - Enable this indexer for when you trigger an interactive search
    • URL -
    • API Path (advanced option) - Path to the api, usually /api
    • API Key - Self Explanatory
    • Categories (advanced option) - Comma Separated list of the numerical categories to be scanned. Leave blank for all
    • Additional Parameters - Self Explanatory
    • [ADD MORE HERE - WIP...some are ARR specific]
    • Early Download Limit -

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 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
  • RSS Sync Interval - Interval in minutes. Set to zero to disable (this will stop all automatic release grabbing)

This will apply to all indexers, please follow the rules set forth by them.

RSS Sync

Lidarr relies on RSS feeds to automate grabbing of releases as they are posted, for both new releases as well as previously released releases being released or re-released. The RSS feed is the latest releases from a site, typically between 50 and 100 releases, though some sites provide more and some less. The RSS feed is comprised of all releases recently available, including releases for requested media you do not follow, if you look at debug logs you will see these releases being processed, which is completely normal.

The Interval

Lidarr enforces a minimum of 10 minutes on the RSS Sync interval and a maximum of 2 hours. 15 minutes is the minimum recommended by most indexers, though some do allow lower intervals and 2 hours ensures Lidarr is checking frequently enough to not miss a release (even though it can page through the RSS feed on many indexers to help with that). Some indexers allow clients to perform an RSS sync more frequently than 10 minutes, in those scenarios we recommend using Lidarr's Release-Push API endpoint along with an IRC announce channel to push releases to Lidarr for processing which can happen in near real time and with less overhead on the indexer and Lidarr as Lidarr doesn’t need to request the RSS feed too frequently and process the same releases over and over.

Lidarr has been offline

If Lidarr has been offline for an extended period of time, Lidarr 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 Lidarr will be able to process the releases it would have missed and avoid you needing to perform a search for the missed episodes.

Download Clients


Download Clients

Completed Download Handling

Failed Download Handling

Remote Path Mappings

Connect


Connections

Metadata


Metadata/Metadata Consumers

Write Metadata to Audio Files

Metadata Provider Source

Tags


General


Host

Security

Proxy

Logging

Analytics

Updates

Backups

UI


This page was last edited on 10 September 2020, at 21:16. Content is available under Creative Commons Attribution-NonCommercial-ShareAlike unless otherwise noted.