r/Lidarr • • Apr 26 '26

The Lidarr wiki got a major overhaul - come test it and tell me what's still missing

53 Upvotes

Over the past few weeks I've been doing a significant cleanup of the Lidarr wiki. The short version: the FAQ had become a dumping ground, half the settings page was blank, and several of the most common questions people ask here had no good page to link to. That's mostly fixed now.

What changed:

The FAQ was rebuilt from scratch based on what people actually ask — the old version had 41 entries, many of which were outdated or answered questions nobody was asking. It's now about 20 focused entries with better answers and links out to deeper pages instead of trying to cram everything into one place.

Two new troubleshooting pages were added that didn't exist before:

  • Import Troubleshooting — covers why a finished download doesn't auto-import, how the match-quality scoring works, when manual import is the right path, and how import list items get resolved. This is probably the most common class of question here.
  • Metadata Troubleshooting — covers missing or wrong albums, the MusicBrainz refresh cycle, how to bust the metadata cache, Various Artists edge cases, and how to actually get a missing release into MusicBrainz so Lidarr can see it.

The Settings page went from partially written to full coverage — every section, including Media Management, all the profile types, Indexers, Download Clients, Connect, General, and the rest.

Custom Scripts was rewritten with real working examples (event logger, Discord webhook, Plex library refresh, health alert) and a corrected variable reference — the old page had incorrect casing on several variables, which silently broke the scripts on Linux.

Tips and Tricks now has a Custom Formats section with working JSON definitions and scoring recommendations for a FLAC-focused library, plus folder structure guidance.

There's also a new Beets Integration page for people running beets alongside Lidarr.


Where you come in:

The goal is for the wiki to be good enough that when someone asks a question here, there's always a link worth sending. I'm not there yet — I know there are gaps.

If you ask a question and the wiki doesn't answer it (or answers it badly), please say so in this thread. That's the most useful feedback. If you search the wiki and can't find something you'd expect to be there, please let me know.

Things I know are still incomplete: the PostgreSQL setup page needs a rewrite, the Contributing guide is outdated, and the Settings page is still missing Quality Profiles and a few other sections. Those are in progress.

The wiki is at wiki.servarr.com/lidarr.


Update: I received some great feedback about AI use breaking the readability. To address this, I have updated my Claude instructions and added Vale to my pipeline.


r/Lidarr • • 42m ago

discussion How do I add music not on MusicBrainz?

1 Upvotes

I know this will be a heated topic because of the nature of it, but here we go.

Recently, I have been expanding my music library and have been noticing some really good and hidden AI- and non-AI-generated (or assisted) tracks and artists that are on streaming platforms or just YouTube, but I cannot add them to Lidarr because they do not have a MusicBrainz record. How can I add these songs and manage them with Lidarr without having to resort to fully manual methods? Indexers and download sources are not a problem, but I just need a way for Lidarr to know they exist.


r/Lidarr • • 3h ago

discussion AOTY & RYM acquisition and Plex collections

0 Upvotes

Does anyone have a method they use to automate bringing Albumoftheyear and RateYourMusic lists into Plex collections, including acquisition through Lidarr or some other acquisition engine?

I would like to be able to keep up with the releases in a certain genre, for example.


r/Lidarr • • 11h ago

waiting for op How to add this item in Lidarr

0 Upvotes

I'm trying to add the following release:

Rolling Stone: 500 Greatest Songs of All Time: 2021 edition

There is an entry for it on MusicBrainz here:

https://musicbrainz.org/series/355b26c9-001e-4728-852e-82b4379adb82

And I went into Add New then typed lidarr:355b26c9-001e-4728-852e-82b4379adb82 but nothing turned up.

Any advice welcome.


r/Lidarr • • 21h ago

Help! Lidarr nightly wont update to v4.0.0.5222

2 Upvotes

Using Lidarr in docker - rebuild the container but it wont pull the lastest version of

image: linuxserver/lidarr:nightly

Its stuck on Version 3.1.2.4914

Anybody with a fix ? or having same or not this issue at all?

r/Lidarr • • 1d ago

Recycle Bin cleanup fixed

1 Upvotes

I hope no one here needs to hear this, but recycle bin cleanup will be fixed in the next develop build.

https://github.com/Lidarr/Lidarr/pull/6027/changes/50c9ac86486a616a0ab744bd18f9fa2d86a6ddb0


r/Lidarr • • 3d ago

unsolved Is there really not a way to force lidarr to import a download even if it's not a perfect match?

9 Upvotes

Half the albums lidarr downloads (mostly from slsk via tubifarry) don't automatically import; they have duplicate files, slightly inaccurate metadata so they don't meet the 80% threshold, etc, but are obviously correctly downloaded and I have to spend a ton of time navigating through the clunky manual import UI to try to get lidarr to import them (which still only works half the time)

From what I can tell this seems to be a recurring issue, but the only solutions I can find anyone suggesting are:

  • "just use manual import": extremely time consuming, awful UI (for example, if lidarr selected one file as track 1 but actually it should be another, it takes 6 clicks to fix - I need to click the track button for the former file, deselect the track, click "select tracks", then click tracks on the latter file, then select the track, then click "select tracks")
  • "file a github issue, it means there's an issue with the matching algorithm": sure, but this happens way too frequently to file an issue for each case
  • "run picard manually before importing": that's quite a lot of work and involves pulling out my laptop, mounting the network share, manually processing each album, then trying to get lidarr to do it again. the whole reason I'm using lidarr is so I don't have to do stuff like that

At this point I'm genuinely unsure how anyone uses this software. seriously how am I supposed to deal with this


r/Lidarr • • 3d ago

Help! Searching for a Lidarr wrapper/companion

Thumbnail reddit.com
0 Upvotes

r/Lidarr • • 5d ago

discussion I made a way to keep Lidarr synced with your Apple Music library (no Mac, no developer account)

9 Upvotes

Lidarr has Spotify and Last.fm import lists but nothing for Apple Music, and the usual workarounds are a Mac with a library export, an Apple developer account, or a paid transfer service.

So I built a small container that works from the iPhone instead:

  • An iPhone Shortcut reads your library's artists on the phone (Apple's own Shortcuts actions) and posts them to the container every night.
  • The container matches them on MusicBrainz and serves them as a Lidarr Custom List.
  • Nothing signs in to your Apple ID, so it stays within Apple's terms.

It handles a household too: each person gets their own token (pasted into the Shortcut as a one-line setup code), Lidarr gets one combined list. There's a web admin (password + optional 2FA) that shows per-person stats, upload history and which names didn't match.

Optional album sync: instead of every album by each artist, Lidarr monitors only the albums actually in your library (albums you already have files for stay monitored). It's off by default and uses a separate version of the Shortcut.

For my library: 342 album artists, 325 matched on MusicBrainz, and Lidarr picked up the new ones on its next list sync.

Repo + screenshots: https://github.com/egamer24/applemusic-lidarr-sync

Feedback welcome, especially on artist matching with libraries very different from mine.

Disclosure: built with AI assistance; I reviewed, tested and run it myself.


r/Lidarr • • 9d ago

unsolved Performance for big library

2 Upvotes

I'm currently in the process of rebuillding my library with lidarr, it got a little excessive...

Right now I have 5k artists and around 30k albums added to it and I have more to go.

I already replaced the database with postgres which helped initialy but currently opening and artist might up to 10 seconds. It's running in a Proxmox lcx docker with plenty of ram and CPU.

Anyone in a similar situation or have any idea how to speed things up?


r/Lidarr • • 11d ago

solved Lidarr not monitoring random artists

0 Upvotes

When I add an artist on lidarr, some random artist won’t monitore properly: the blue bar underneath stays forever and, although it says “monitored”, it doesn’t show any albums or songs.
I’ve tried removing the artists and adding them again, but it won’t work. I first thought that the artists weren’t on the musicbrainz data base, but I’ve checked it and they all exist. The metadata profile is on standard (primary types: album, secondary types:studio).
One example of this is offspring. Other artists work just fine.
Thank you in advance!


r/Lidarr • • 14d ago

unsolved How to import audio files automatically?

2 Upvotes

Hello there, I have ~1,000 audio files named {artist} - {song name} but also with all the metadata encoded. However, they are not sorted in artist and album subfolders. I would like to know how to make Lidarr automatically import these files without having to specify manually to which artist/album they belong or have to add the artist manually. Thanks!


r/Lidarr • • 21d ago

waiting for op Help with Soundtrack

1 Upvotes

Hi all,

I am having an issue adding this soundtrack to lidarr:

Top Gun: Maverick: Music From the Motion Picture

Catalog# 0060244584512

MBID: https://musicbrainz.org/release/32039468-2c15-45db-b9e1-f3f0d3a75101

I can't figure out how to stop it from tagging the album to Lorne Balfe.

Ideally I would be ok with it putting it in Various Artist like all other Soundtracks, or even Harold Faltermeyer, who is the correct 'main artist' for the release.

In MusicBrainz Lorne is tagged first is a couple of the releases (not the one I am using), I assume due to last name organization.

Is there any way to alter this?

TIA!


r/Lidarr • • 22d ago

unsolved Search not working?

1 Upvotes

Hi everyone, i have setup an arr stack on my homelab and at first all went smoothly but right now whenever i search for the monitored songs on lidarr i receive the following message.
0 reports downloaded.
I dont really get what that means
Is that an indexer issuer or a lidarr issue?
Can that be fixed or is that a wait till it fixes itself issue?
Could someone also explain how the search works on a techincal level?
the indexers are: nzbgeek, althub, nzbplanet, 1337x, extratorrent, kickasstorrents

thank you


r/Lidarr • • 24d ago

solved Lidarr not seeing other valid release in release group

2 Upvotes

Apologies in advance if I'm missing something obvious here, but I can't seem to figure this one out.

I added a new release (6cbcdbdb-07c1-41bc-acda-71fac46021b5) to an album (812e2571-4838-3ea9-8836-9188e62a376b) I have as the only other existing release of this album on MusicBrainz has a different number of tracks, which then obviously causes issues with file mapping in Lidarr.

However, I've waited quite a while now for this to sync through to Lidarr, however it still doesn't seem to and I can't figure out why. Manually deleting the album from Lidarr and re-adding it via the MBID still only shows 1 release available, so it's definitely not picking up the new one I've added for some reason.

Now, from reading around I know that there are two common reasons why Lidarr might not pick up a MB release, both of which I believe shouldn't apply here:

  • The edit needs time to be picked up by the Lidarr sync - the new release edit has been valid (i.e. not waiting for approval) for over 2 weeks now
  • The release is not marked as 'Official' - I have tripled checked that it is showing as such in MB

Does anyone else have any other ideas or insight as to why this might not be getting picked up as a valid release? Is there something I've missed in the details on MB? I've compared the two releases and can't see any fields that aren't completed on the new release vs. the old one.

I haven't included any logs as I assume they wouldn't say much since the whole issue is Lidarr not even acknowledging the release, but can do if they would be helpful.


r/Lidarr • • 25d ago

discussion How Tubifarry's Slskd search actually works (fallback tiers, Minimum Results, and blocked terms

16 Upvotes

Claude and I went through the Tubifarry source to figure out why some Soulseek searches send a dozen queries and others send one. None of this is in the README or the setting help text, so I'm sharing it in case it's useful. This is based on the source as of early October 2026 and may change in later releases. It's unofficial, so for support, use the Tubifarry repo.

The short version

Tubifarry doesn't send one query per album search. It builds an ordered list of query strategies and runs them one at a time, stopping as soon as one returns enough results.

How the chain runs

  1. It classifies the album. It checks for Various Artists releases, self-titled albums, very short album titles, EPs and singles that need the release type added, volume numbers, Roman numerals, and accented characters or punctuation.
  2. It orders the strategies in four groups: Special, Base, Variation, then Fallback. Strategies that are turned off or don't apply to this album are skipped.
  3. Each strategy is its own tier. Tiers run in order, and a tier's query isn't built until that tier runs.
  4. It stops at the first tier with usable results. With Minimum Results set to 0, one result is enough. Otherwise, the tier needs at least that many results. The count is per tier, not a running total. Results from earlier tiers are still kept.
  5. It never sends the same query twice.

The strategies, in order

StrategySettingWhat it searches for
TemplateSearch TemplatesYour custom template
Various Artists / Self-Titled / Short NameAlways on, when they applyAlbum or artist, plus the year and release type
Base SearchAlways onArtist + album, plus the year if Append Year is on
Volume Variation / Roman NumeralVolume VariationsSwaps formats, for example Vol. 1 and Volume I
Edition StrippedAlways on, when the title has edition textRemoves text like "(Deluxe Edition)" or "Remastered"
NormalizedNormalize SearchRemoves accents and punctuation
Trimmed FallbackEnable Fallback SearchShortens words by one letter to match more broadly
Partial Album / Distinctive AlbumEnable Fallback SearchArtist + only the most distinctive words of the album title
Artist AliasEnable Fallback SearchAn artist alias from metadata + album
Track FallbackTrack FallbackArtist + the album's longest track title
Blocked Term EvidenceAlways on, when it appliesSee below

Blocked search terms

The Soulseek server filters certain search phrases. Tubifarry has its own hardcoded list of about 30 terms, mostly big artist names and a few album and song titles. You can't edit the list from Lidarr.

When a query contains one of these terms, Tubifarry first tries adding an accent to get past the filter, for example Beyonce becomes Bèyonce. If that isn't possible, it drops the word. As a last resort, it removes the blocked words and searches with a track title from the album instead.

Related: slskd receives the server's real list of excluded phrases but doesn't expose it through its API. You can see it by turning on debug logging in slskd and searching the log for Excluded search phrases.

Things that may catch you out

  • Track Fallback works on its own. The help text says it needs Enable Fallback Search, but in the current code it runs whenever Track Fallback is on.
  • Track Fallback tries only one track, the one with the longest title.
  • A high Minimum Results means many queries. Each tier has to reach the number on its own, so a high value can run most of the chain for every album. On Soulseek, that can slow you down or get you rate-limited.
  • Edition Stripped and Blocked Term Evidence have no setting. They always run when they apply.

See it for yourself

Turn on debug logging in Lidarr and run a search. Each query appears as [Strategy Name] Search: '<query>', and the tier that ended the search appears as Tier N found X usable results.

Corrections are welcome. I'll update the post if anything's wrong.


r/Lidarr • • Oct 18 '26

waiting for op Version numbers - latest release is Nov 2025?

2 Upvotes

I have just upgraded my hypervisor, and in the process did some optimization of all my containers and VMs, ensuring everything is up-to-date.

I noticed that Lidarr is showing I am on the latest version 3.1.0.4875 (2025-11-16). When I look at the GitHub repo, I can see that seems to be accurate, and everything since then is only "Pre-release". It seems I'm about 70 commits behind the latest pre-release.

Is that correct, or am I missing something?


r/Lidarr • • Oct 17 '26

unsolved Remove Download Handling Health Alert

4 Upvotes

I’ve read all the forums but just wanted to check one last time that there isn’t a way to disable the health alert for download handling?

I use Lidarr to search indexers for music. That’s it. I have SAB import the music straight to my Apple Music “Automatically Add” folder. The music is then matched to Apple Music. Later down the line I have Plex scan the Apple Music folder to ensure all my music is tagged correctly. Works a charm and ensures all my music is matched with Apple Music’s high quality library (high enough for me anyway)

But lidarr doesn’t like not managing the library for me and alerts me of this at every opportunity.

Work around or deal with it?

Thanks


r/Lidarr • • Oct 16 '26

unsolved Lidarr metadata isn't writing 'album artist' from musicbrainz?

1 Upvotes

Is it possible to define what metadata from musicbrainz gets written? For some reason lidarr will not write metadata for 'album artist' or 'album artist sort' so I have to manually add each new download into picard to add those. Would be nice to be able to do this automatically.


r/Lidarr • • Oct 16 '26

discussion How do you name your songs?

0 Upvotes

Need suggestions on the naming scheme and the folder organization in general.

Not usually in music so I'm a bit stuck here. Numbers at the start of each track doesn't look good in the eye for me at this point.

But I don't know, some albums care about the story as a whole so it matter sometimes. But again, not that into music.


r/Lidarr • • Oct 15 '26

solved Existing Library

1 Upvotes

Hello,

Love the ARR stack! I just added Lidarr to my Gluetun stack and I'm having problems with my large existing music library. When I add my existing library as the root folder, it picks up most of the media and imports it into the db, but there are several albums that do not get registered in the Lidarr db. It can see the file because they go into Unmapped. I tried adding them, but it does not change after running through the files again.

I checked my Metadata profile, and I have all the relevant primary and secondary types checked. I also set it up to tag all files.

These are not obscure albums - most of them are top 40. Am I doing something wrong? Is there a better way to import an existing library to make sure everything is picked up.

TIA for any assistance!


r/Lidarr • • Oct 12 '26

discussion I just started using Lidarr

17 Upvotes

And wow, I wish I had started sooner.

I avoided it for along time because the UI is not that up to date and I assumed I'd have to have the entire *arr stack setup. Turns out nope. I can get a plugin to connect to slskd and even with just that it's incredible. I installed another plugin that automatically every hour grabs albums that are missing and it just works. No fiddling around with settings. Not fighting with my beets config. Or constantly trying different tools like soulsync.

My only complete is that I've struggled to setup any way to get more obscure music. Sometimes Lidarr will say an artist has no releases when they clearly do. But for now everything is awesome.

Anyways wasn't sure what flair to use so let's discuss our success with this awesome program.