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 • • 1d ago

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

8 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 • • 1d ago

Help! Searching for a Lidarr wrapper/companion

Thumbnail reddit.com
0 Upvotes

r/Lidarr • • 3d 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 • • 7d 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 • • 9d 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 • • 12d 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 • • 18d 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 • • 20d 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 • • 22d 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 • • 23d 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 • • 29d ago

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.


r/Lidarr • • Oct 11 '26

discussion Music Video Downloader - a script for downloading music video based upon your music library database

6 Upvotes

I wanted music videos for the artists in my library without doing it all by hand, so I built a desktop app for it. I put it together with a lot of help from Claude (the AI). It's not a polished product, but it works for me and I thought others might find it useful.

It starts by reading your database for Lidarr, Kodi, Plex, Jellyfin or Emby to get a list of your artists and MusicBrainz IDs. Then it searches IMVDb, Wikipedia and YouTube for their videos and combines everything into one list. Missing years, albums and genres get filled in from your library and MusicBrainz. The list won't be perfect, so you can edit it yourself: rename a title, change a link, or exclude a song or a duplicate.

It downloads the videos with yt-dlp and puts them in the right folders for your media server, with NFO files, tags and artwork. Anything without an album or year is skipped. If you add the album or year yourself, it won't be skipped. After that you can go through the Review tab, play what you got, and replace or delete the ones that are wrong. You can also have it write a short description for each video. Once you've done every step by hand, Auto Run can keep going on a PC that's always on and fetch new videos by itself. By default it works overnight, but you can set the hours to all day.

The first tab is a Setup page that checks what you need and installs the Python packages for you. You need Python 3.10 or newer, ffmpeg, a free fanart.tv API key and your email for MusicBrainz. mpv is optional, for the player. You can import your settings from a previous version.

One thing to know: YouTube will block you if you download hundreds of videos without being signed in, so you'll want a cookies.txt from a spare Google account (not your main one). The README explains how. When a block starts the app stops, and Auto Run waits a few hours and carries on.

I've only tested it on Linux, but it should work on Windows too. I really dont know what needs to done on windows to make it work yet. It may just work idk.

Just to be clear i made this script with Claude AI with not mush knowledge of python. It works for me when i direct it to the lidarr database.

https://drive.google.com/file/d/1OBq64CKtVwbb46OAQu-kkZDy6ADaJqQe/view?usp=sharing

EDIT: Just updated the link to a newer version, will put this on github at some point. really it just up for testing. so still a few changes and possible bugs that may need fixing in future.

2nd EDIT: Last update on reddit for the file. I will move this over to github within the next week. Added BgUtils POT Provider helper script. it will start a docker or podman container. Info on the setup page.

3rd and final EDIT: i am in the process making this into a docker container with a web ui. so something similar to lidarr but for music videos. so that mean the desktop gui will go.


r/Lidarr • • Oct 09 '26

solved Youtube Download client

22 Upvotes

Does anybody have a decent solution on how to setup the Youtube download client for Lidarr? The trusted-session-generator project is apparently deprecated so I went with Invidious, no idea how to set it up for generating PoTokens and Visitor Data though.

I'm using the latest version of the Tubifarry plugin, slskd integration works like a charm but it still doesn't get me all the music I want.

If you have any recommendation for different download clients or indexers aswell I'm all ears, just want a working setup for my music needs.

Edit: I managed to make it work. The Tubifarry main branch is currently not working properly! Change to develop by entering this in the GitHub URL field: Tubifarry@TypNull#develop

Use "Youtube" as indexer and download client. Add the cookie.txt to both. You can extract it by using any browser addon that does this, just go to youtube.com, log in if you're not already and download the cookie.txt file. Then you can simply upload it to your server and link to it in the indexer and donwload client setup.


r/Lidarr • • Oct 09 '26

discussion OpAmp - Desktop client for Plex with Lidarr integration

0 Upvotes

Hey all, just thought I’d share this with you all. Started building OpAmp almost a year ago, its a desktop client for the Plex Media Server that integrates into a few other services, like Lidarr for downloding suggestions, missing artist albums and by searching.

A few highlights:

  • Transition modes

    • Off (gap)

    • Gapless

    • Sweet Fade

    • Beat Matching

  • Playlist folders

  • DJs

    • The ones known from Plexamp

    • Auto Mix - turns on Beat Matching and controls the queue by filling in bpm gaps and keeps the music going after your queue has ended

  • Browse multiple servers as one

  • Lyrics

  • Mini/Flat/Full view modes

  • Command Palette style search and action menus (ctrl/cmd+f, ctrl/cmd+k)

You can learn more about it on the website: https://opamp.app
and join the Discord if you want to help shape the app: https://discord.gg/vXqDEW3mrV

It’s Free. And available on macOS and Windows :)


r/Lidarr • • Oct 09 '26

discussion Lyris is now on the appstore !

0 Upvotes

A few months ago I shared Lyris here, my navidrome iOS player with a native Lidarr integration, and then Jellyfin support. A lot of you joined the beta, and your feedback shaped a huge part of the app. Thank you for that.

Today Lyris is officially on the App Store: https://apps.apple.com/app/id6764873657

For those who missed it Lyris is an iOS navidrome and Jellyfin music player with a native Lidarr integration and a recomendation engine that recomend albums outside your library but based on your listening.

The app features:

- navidrome and Jellyfin support

- native Lidarr integration: search, add, done

- discovery that suggests stuff outside your library based on what you actually listen to

- CarPlay support

- offline downloads, smart playlists, lyrics, equalizer, and more

Pricing: free to download, 7-day free trial, then a one-time unlock. No subscription.

If you were a beta tester, update to the latest TestFlight build, there's a little thank-you discount code waiting for you in the app.

Can't wait to have your feedback!


r/Lidarr • • Oct 05 '26

Lidarr Plugins Wiki Page Updpated

25 Upvotes

I reorganized the Lidarr Wiki plugins page; let me know if I missed any or if you have any feedback.

https://wiki.servarr.com/lidarr/plugins


r/Lidarr • • Sep 30 '26

discussion Hearr: a music discovery and request app for Lidarr

35 Upvotes

I've been missing a "Seerr for music", so I built one. Hearr sits in front of Lidarr: you browse music, and it sends what you pick to Lidarr.

What it does

- Charts: Deezer's Top 100 for the countries you choose (global, US, UK, FR, DE, TR…), plus top albums, artists and songs per genre

- Discover: artists similar to what's already in your Lidarr library

- New: recent releases from your artists

- Browsing: full discographies with 30-second previews

- Requests: one click to request an album. It asks for quality (your Lidarr profiles) and shows the estimated size and free disk space first.

- Status on every album: in library, downloading, searching, or "Search now" when Lidarr wants it but isn't looking

- Remove: unmonitors the album, deletes its files and deletes the seeding torrent

- Sign-in with Plex: only people you share your Plex server with get in, and only you can delete

- Recommended for you: personalised artist picks based on what's already in your Lidarr library. For each of your artists, Hearr pulls Deezer's "fans also like" list, skips anyone you already have, and ranks the rest by how many of your artists they're related to. So an artist similar to three of yours beats one similar to only one. Each card shows why ("Like Linkin Park, Evanescence").

How it works: music data comes from Deezer's public API, so there's no API key to set up. Requests go through Lidarr's own API and metadata, so Hearr doesn't need MusicBrainz access. It's a single Docker container (FastAPI + plain JS), MIT licensed, with images for amd64 and arm64.

Heads-up: it's early. I've tested it on one setup (Lidarr 3.1 + qBittorrent + Plex on a Mac mini). Brand-new singles sometimes aren't in Lidarr's metadata yet, and Hearr tells you when that happens instead of guessing. I built it with a lot of help from an AI coding assistant, and I've reviewed and tested it on my own server. Issues and PRs are welcome.

GitHub: https://github.com/nurulmac11/hearr