Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions lidarr/beets-integration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Lidarr and beets Integration
description:
description:
published: true
date: 2026-05-03T15:10:07.217Z
tags: lidarr, beets
Expand Down Expand Up @@ -201,4 +201,4 @@ Two scenarios where the tools can conflict:
- [Custom Scripts](/lidarr/custom-scripts) — environment variables available to scripts and how to register them
- [Settings → Metadata](/lidarr/settings#metadata) — Write Tags setting and metadata consumer options
- [beets documentation](https://beets.readthedocs.io/en/stable/)
- [beets installation guide](https://beets.readthedocs.io/en/stable/guides/installation.html)
- [beets installation guide](https://beets.readthedocs.io/en/stable/guides/installation.html)
2 changes: 1 addition & 1 deletion lidarr/custom-scripts.md
Original file line number Diff line number Diff line change
Expand Up @@ -398,4 +398,4 @@ curl -s -X POST "$WEBHOOK_URL" \
## See also

- [Settings → Connect](/lidarr/settings#connections) — where you register scripts in the Lidarr UI
- [Beets Integration](/lidarr/beets-integration) — using a custom script to invoke beets for tag enrichment after import
- [Beets Integration](/lidarr/beets-integration) — using a custom script to invoke beets for tag enrichment after import
34 changes: 17 additions & 17 deletions lidarr/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ If you don't find your question here, the most common landing spots are [Metadat

## Basics

### How does Lidarr work?
### How does Lidarr work

Lidarr doesn't search for files that are missing or haven't met quality goals on a schedule. Instead, it queries your indexers and trackers at a steady cadence for *all* newly posted releases, compares that feed with your monitored albums, and downloads matches. At an RSS interval of 15–60 minutes, this amounts to 24–100 queries per day and covers a library of any size. It only catches releases going forward from when you added them, though.

Expand All @@ -31,7 +31,7 @@ If Lidarr has been offline for a while, it pages back through each indexer to fi
- Adding an artist or album with *Add and Search*.
- Albums discovered during an artist metadata refresh (for example, a new album MusicBrainz adds after you've already added the artist).

### How do I update Lidarr?
### How do I update Lidarr

Lidarr runs on one of three release branches. Pick one under **Settings → General → Updates** (show advanced):

Expand Down Expand Up @@ -59,7 +59,7 @@ Docker tag-to-branch mapping:

## Finding music and MusicBrainz

### Why doesn't artist X show up in search?
### Why doesn't artist X show up in search

A few common causes:

Expand All @@ -84,7 +84,7 @@ Type any of these into the Lidarr search box. Lidarr tries to resolve the MBID a
> **Release vs Release Group is the single most common mistake.** For albums, Lidarr wants the *Release Group* MBID, not a *Release* MBID. A release group is "the 2005 album"; a release is "the 2005 US CD pressing" or "the 2005 UK vinyl." If you paste a release MBID, the lookup will fail or return unexpected results.
{.is-warning}

### Why does Lidarr only show studio albums, how do I find singles or EPs?
### Why does Lidarr only show studio albums, how do I find singles or EPs

Lidarr filters what to track per artist through a **Metadata Profile** (Settings → Profiles → Metadata Profiles). The default profile includes only *Studio* albums, which is why singles, EPs, live albums, compilations, and remix collections don't appear on a fresh install.

Expand All @@ -98,7 +98,7 @@ Adjust the profile rather than per-artist settings for a library-wide change:

To apply a changed profile to existing artists, go to Library, select the artists, and use Edit → Metadata Profile.

### How can I find a MusicBrainz ID?
### How can I find a MusicBrainz ID

1. Search the artist, release group, or release on [MusicBrainz](https://musicbrainz.org/search). For albums, set the search type to **Release Group**.
2. Open the entity page. The MBID appears under the **Details** tab, or at the end of the URL (the UUID after the last slash).
Expand All @@ -124,7 +124,7 @@ MusicBrainz doesn't have track lengths for this release (they appear as `???` on

## Importing and renaming

### I'm having trouble importing my artists, what could it be?
### I'm having trouble importing my artists, what could it be

Imports fail in one of a few ways:

Expand All @@ -133,7 +133,7 @@ Imports fail in one of a few ways:
- **Lidarr can't read or write the folder.** The user account Lidarr runs as must have read and write access to both the download folder and the destination root folder. On Linux this is a UID/GID/permissions issue on a mount; on Windows it's Lidarr running as `LocalService` which can't reach a network share. See [Why can't Lidarr see my files on a remote server?](#why-cant-lidarr-see-my-files-on-a-remote-server) for the Windows case.
- **Untagged or badly tagged files.** Files with generic filenames like `track01.mp3` and no tags give Lidarr nothing to match on. Run a tagger such as [MusicBrainz Picard](https://picard.musicbrainz.org/) or [Harmony](https://harmony.pulsewidth.org.uk/) before importing. See [Import Troubleshooting → Untagged or badly tagged files](/lidarr/import-troubleshooting#untagged-or-badly tagged-files).

### How can I rename my artist folders?
### How can I rename my artist folders

{#rename-folders}

Expand All @@ -160,13 +160,13 @@ If a rename appears to have happened in Lidarr but the folder name on disk hasn'
> **Renaming outside Lidarr breaks the link between Lidarr's database and the files on disk.** Lidarr tracks files by path. If you rename a folder at the OS level, Lidarr treats the files as missing and may re-download them. Always rename through the Lidarr UI when possible.
{.is-warning}

### Why does Lidarr keep trying to rename the same folders?
### Why does Lidarr keep trying to rename the same folders

Almost always a case-only rename on Windows. Windows filesystems treat `Artist` and `artist` as the same path. When Lidarr renames `ARTIST` to `Artist`, the operation reports success but the folder name on disk doesn't change. Lidarr then sees the folder still needs renaming, and the cycle continues.

The fix is a two-step manual rename (`Artist` → `Artist_tmp` → `Artist`) so the filesystem actually commits the case change. On Linux and macOS this isn't an issue because those filesystems are case-sensitive.

### What audio formats does Lidarr support?
### What audio formats does Lidarr support

Lidarr recognises the following file extensions:

Expand All @@ -178,7 +178,7 @@ A subset of these formats have named quality definitions that quality profiles a

If a file with a supported extension still isn't importing, the issue is typically match quality rather than format. See [Import Troubleshooting](/lidarr/import-troubleshooting).

### Can Lidarr prefer a specific pressing or format during import?
### Can Lidarr prefer a specific pressing or format during import

{#can-lidarr-prefer-a-specific-pressing-or-format-during-import}

Expand All @@ -198,7 +198,7 @@ An [open feature request](https://github.com/Lidarr/Lidarr/issues/186) to expose

## Lists and automation

### Why are list sync times so long and can I change it?
### Why are list sync times so long and can I change it

List sync is intentionally slow. Lists are an *"add eventually"* tool, not an *"add now"* tool. The original sync cadence overwhelmed the upstream Servarr metadata server when users ran 10-minute list refreshes.

Expand All @@ -211,7 +211,7 @@ If you need faster feedback for a specific list:
> **Spotify import lists can trigger rate-limit errors (429s).** When Lidarr processes a Spotify list, it resolves Spotify IDs to MusicBrainz IDs via the metadata server cache. Any ID not in the cache requires an individual lookup, and enough of those in quick succession will hit the rate limit. To resolve this, wait it out, or add the missing Spotify album links to MusicBrainz so they get cached. See [Metadata Troubleshooting → Spotify import list rate limiting](/lidarr/metadata-troubleshooting#spotify-import-list-rate-limiting) for the full mechanism.
{.is-info}

### Does Lidarr download lyrics, liner notes, or other extras?
### Does Lidarr download lyrics, liner notes, or other extras

No, by design. Lidarr fetches the release audio files and tags/organises them. It doesn't bundle lyrics, liner notes, or other secondary files.

Expand All @@ -222,7 +222,7 @@ For lyrics, use a tag-aware companion tool:

These can run alongside Lidarr against the same library. Run them after Lidarr imports so they don't fight over file ownership.

### What about Custom Scripts / Custom Formats / post-processing?
### What about Custom Scripts / Custom Formats / post-processing

Lidarr supports two distinct extension points:

Expand All @@ -233,7 +233,7 @@ Custom Formats score releases. Custom Scripts respond to events. They don't over

## Integrations and external tools

### Does Lidarr support Deemix, slskd, or similar tools?
### Does Lidarr support Deemix, slskd, or similar tools

Deemix and slskd are third-party tools. Deemix is a Deezer downloader. slskd is a Soulseek daemon. Historically there was no built-in way to integrate them with Lidarr, and users cobbled together import scripts.

Expand All @@ -243,7 +243,7 @@ Common community plugins cover exactly this ground: Soulseek, Deezer, Tidal, and

Running the plugin branch requires switching to `nightly` (see [How do I update Lidarr?](#how-do-i-update-lidarr)). Database schema migrations mean switching back to `master` or `develop` afterward requires restoring a pre-switch backup.

### Which download clients does Lidarr support?
### Which download clients does Lidarr support

Usenet (NZB): SABnzbd, NZBGet, NZBVortex, Pneumatic, usenet blackhole.

Expand All @@ -253,7 +253,7 @@ More clients are available via [Plugins](/lidarr/plugins) on the `nightly` branc

For setup recipes, the [TRaSH Guides — Downloaders](https://trash-guides.info/Downloaders/) section covers the common clients in more depth than the Lidarr wiki does.

### Does Lidarr integrate with Plex, Emby, or Jellyfin?
### Does Lidarr integrate with Plex, Emby, or Jellyfin

Not directly. Lidarr manages the library on disk. Media servers read that library and serve it to clients. The common pattern is to share the root folder:

Expand Down Expand Up @@ -316,7 +316,7 @@ Common causes:
- **Permissions.** If the Lidarr user can't write to the database file, SQLite can leave it in a corrupt state. This primarily affects new installs, migrated installs, or systems where the running user/group changed recently.
- **mergerFS with `direct_io` enabled.** SQLite uses mmap, which mergerFS `direct_io` doesn't support. See [mergerFS docs](https://github.com/trapexit/mergerfs#plex-doesnt-work-with-mergerfs). Remove `direct_io` from the mergerFS options.

### I use Lidarr on a Mac and it stopped working. What happened?
### I use Lidarr on a Mac and it stopped working. What happened

Most likely one of the databases is corrupt — a known macOS issue when the system sleeps or crashes during a database write. See [I am getting an error: Database disk image is malformed](#i-am-getting-an-error-database-disk-image-is-malformed) above for recovery.

Expand Down
2 changes: 1 addition & 1 deletion lidarr/import-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -196,4 +196,4 @@ For advanced readers who want to verify the rules or trace a specific rejection,
- [Importing an Existing Library](/lidarr/importing-existing-library) — the fresh-install import walkthrough
- [Metadata Troubleshooting](/lidarr/metadata-troubleshooting) — for problems where the release is missing or wrong at MusicBrainz
- [FAQ](/lidarr/faq) — shorter answers that didn't fit this page
- [MusicBrainz Picard](https://picard.musicbrainz.org/) — tag files with MBIDs before importing for a dramatically higher succes
- [MusicBrainz Picard](https://picard.musicbrainz.org/) — tag files with MBIDs before importing for a dramatically higher success rate
8 changes: 4 additions & 4 deletions lidarr/importing-existing-library.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,13 +38,13 @@ For the automated import to succeed, structure and tag your files before pointin

The recommended structure is:

```
```text
<Root Folder>/<Release Artist>/<Release>/<Track>
```

For example:

```
```text
/music/Bob Dylan/Blood on the Tracks/01 - Tangled Up in Blue.flac
/music/Bob Dylan/Blood on the Tracks/02 - Simple Twist of Fate.flac
```
Expand Down Expand Up @@ -114,7 +114,7 @@ The three asterisked fields above become the defaults for every artist the impor

## After import

Once the scan finishes, plan on a review pass. Even a well-prepared library will produce a small number of mismatches, and finding them early is cheaper than discovering them weeks later when Lidarr downloads the "missing" half of a mis-linked `Release`.
Once the scan finishes, plan on a review pass. Even a well-prepared library will produce a small number of mismatches, and finding them early is cheaper than discovering them weeks later when Lidarr downloads the "missing" half of a mislinked `Release`.

- **Check the library view** for artists with zero monitored `Releases`. Usually means the metadata profile filtered everything out; widen the profile or change it for that artist.
- **Look for wrong-release matches.** Pick a few albums at random and verify the tracklist on the artist page matches what you have on disk. Mismatches most commonly appear with re-releases, remasters, and region-specific pressings — the text match picked a different `Release` than the one you own. Use the **Manual Import** or **Search for MusicBrainz ID** workflow to re-link.
Expand All @@ -132,4 +132,4 @@ If a `Release` or `Release Artist` you expect is genuinely missing from MusicBra
- [Concepts](/lidarr/concepts) — the `Release` and `Artist` model that drives import behavior
- [Quick Start](/lidarr/quick-start-guide) — install and first download, if you don't already have a library
- [FAQ](/lidarr/faq) — common import and metadata issues
- [Settings](/lidarr/settings) — detailed reference for every option referenced on thi
- [Settings](/lidarr/settings) — detailed reference for every option referenced on this page
4 changes: 2 additions & 2 deletions lidarr/installation/reverse-proxy.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Lidarr Reverse Proxy
description:
description:
published: true
date: 2026-04-26T16:31:38.023Z
tags:
tags:
editor: markdown
dateCreated: 2023-07-03T20:10:58.279Z
---
Expand Down
4 changes: 2 additions & 2 deletions lidarr/metadata-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ To add a Spotify relationship on MusicBrainz: open the release, go to **Edit**
> A 429 from Spotify doesn't indicate anything wrong with your Lidarr setup — it's a server-side rate limit on lookups. Checking Lidarr's logs at Debug level will show the 429 responses if you want to confirm that's the cause.
{.is-info}

## Retry or wait?
## Retry or wait

| Situation | Action |
|---|---|
Expand All @@ -214,4 +214,4 @@ To add a Spotify relationship on MusicBrainz: open the release, go to **Edit**
- [FAQ](/lidarr/faq) — shorter answers and the operational questions that don't fit this page
- [Harmony](https://harmony.pulsewidth.org.uk/) — recommended tool for importing releases into MusicBrainz
- [MusicBrainz Userscripts](https://musicbrainz.org/doc/Guides/Userscripts) — browser userscripts for MusicBrainz editing (watch the album-type caveat above)
- [Servarr Discord](https://lidarr.audio/discord) — where cache-bust reque
- [Servarr Discord](https://lidarr.audio/discord) — where cache-bust reque
49 changes: 49 additions & 0 deletions lidarr/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,3 +192,52 @@ TrevTV develops specialized Lidarr plugins for direct music platform integration

> See the [Tubifarry README](https://github.com/TypNull/Tubifarry) for advanced configuration, troubleshooting, and feature deep-dives.
{.is-info}

## jtstothard/lidarr-plugin-bandcamp

[Bandcamp by jtstothard](https://github.com/jtstothard/lidarr-plugin-bandcamp)

Bandcamp indexer and download client for Lidarr nightly. Searches your Bandcamp collection for albums you've bought and downloads them. Only works with music you own — there is no public catalog search.

Requires cookie-based auth using the `identity` cookie from your browser.

### Prerequisites

- Lidarr nightly branch
- A Bandcamp account with purchased music
- The `identity` cookie exported from your browser

### Post-Install Configuration

#### Indexer

- Navigate to `/settings/indexers`, and select the <kb>+</kb> button under Indexers. Bandcamp will appear at the bottom under the Other section.
- Paste your `identity` cookie value into **Session Cookies**.
- Select the Test button, then Save.

#### Download Client

- Navigate to `/settings/downloadclients`, and select the <kb>+</kb> button under Download clients. Bandcamp will appear at the bottom under the Other section.
- Paste your `identity` cookie value into **Session Cookies**.
- Set **Download Path** to somewhere Lidarr can write (e.g. `/downloads/bandcamp`).
- Select the Test button, then Save.

#### Delay Profile

- Navigate to `settings/profiles` and scroll down to Delay Profiles
- Select the wrench icon on the profile you want to use Bandcamp with
- Select the Bandcamp protocol, and select Save.

### Exporting the Cookie

**Chrome:** Open DevTools (`F12`) → Application tab → Cookies → `https://bandcamp.com` → copy the `identity` value.

**Firefox:** Open Developer Tools (`F12`) → Storage tab → Cookies → `https://bandcamp.com` → copy the `identity` value.

The cookie expires over time. When downloads fail with auth errors, grab a fresh one.

### Troubleshooting

- **Auth errors** — Cookie expired, re-export it from your browser
- **No search results** — Check that you bought the album on Bandcamp and that the Bandcamp protocol is enabled in your Delay Profile
- **Plugin missing** — Make sure Lidarr is on the nightly branch and restart
Loading