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-29T13:03:01.899Z
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 @@ -18,7 +18,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 @@ -32,7 +32,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 @@ -60,7 +60,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 @@ -85,7 +85,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 @@ -99,7 +99,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 @@ -125,7 +125,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 @@ -134,7 +134,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 @@ -161,13 +161,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. See [Renaming or moving files outside Lidarr](/lidarr/tips-and-tricks#renaming-moving-outside-lidarr) for a full explanation and recovery steps.
{.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 @@ -179,7 +179,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 @@ -199,7 +199,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 @@ -212,7 +212,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 @@ -223,7 +223,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 @@ -234,7 +234,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 @@ -244,7 +244,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 @@ -254,7 +254,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 @@ -317,7 +317,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 succes
6 changes: 3 additions & 3 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 @@ -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 thi
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 @@ -194,7 +194,7 @@ To add a Spotify relationship on MusicBrainz, open the release and go to **Edit*
> A 429 from Spotify doesn't mean anything is 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 @@ -213,4 +213,4 @@ To add a Spotify relationship on MusicBrainz, open the release and 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
7 changes: 1 addition & 6 deletions lidarr/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ image: lscr.io/linuxserver/lidarr:nightly

> Both plugins and this documentation are community-driven. No official recommendations exist. Each developer supports their own plugin.
{.is-info}

## jtstothard/UniqueSingles

[UniqueSingles by jtstothard](https://github.com/jtstothard/lidarr-plugin-uniquesingles)
Expand Down Expand Up @@ -185,7 +186,6 @@ To search, you must also add Slskd as an Indexer.

Slskd is now available for both automatic and interactive searches. During Lidarr search operations you can view the slskd `/searches` as they occur and monitor `/downloads`.


## TypNull/Tubifarry

[Tubifarry by TypNull](https://github.com/TypNull/Tubifarry) is a *multi-feature* plugin that extends Lidarr's capabilities with these key functions:
Expand Down Expand Up @@ -219,7 +219,6 @@ Slskd is now available for both automatic and interactive searches. During Lidar
> See the [Tubifarry README](https://github.com/TypNull/Tubifarry) for advanced configuration, troubleshooting, and feature deep-dives.
{.is-info}


## TrevTV

TrevTV develops specialized Lidarr plugins for direct music platform integration.
Expand Down Expand Up @@ -257,7 +256,6 @@ TrevTV develops specialized Lidarr plugins for direct music platform integration
- FFmpeg required for Tidal conversions
- Qobuz authentication may require custom app IDs


## ta264/deemix

[Deemix plugin by ta264](https://github.com/ta264/Lidarr.Plugin.Deemix)
Expand All @@ -266,9 +264,6 @@ This plugin enables Lidarr to search Deezer using Deemix. You must have a workin

[Deemix](https://github.com/bambanah/deemix)


## lucapolesel/Lidarr.Plugin.Slskd

[Slskd (Soulseek) by lucapolesel](https://github.com/lucapolesel/Lidarr.Plugin.Slskd)


7 changes: 0 additions & 7 deletions lidarr/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,6 @@ Click **Add (+)** to add a root folder. The path must exist and Lidarr must have
> Don't point a root folder at a cloud storage mount (Dropbox, OneDrive, Google Drive). Lidarr writes audio tags and metadata frequently; cloud storage APIs have rate limits that will cause failures.
{.is-warning}


## Metadata Profiles

{#metadata-profiles}
Expand Down Expand Up @@ -155,7 +154,6 @@ You can include or exclude secondary types (Compilation, Soundtrack, Spokenword,
> MusicBrainz determines release types. If a release you expect to see is missing, check its entry on MusicBrainz: the type may be `Unknown`, which Lidarr can't filter on, or the primary type may be one you have unchecked in your profile.
{.is-info}


## Release Profiles

{#release-profiles}
Expand All @@ -176,7 +174,6 @@ Release profiles filter and score releases based on their titles. Use them to re
> Release profiles apply at **grab/download time**: they filter and score releases from indexers before Lidarr sends anything to a download client. They have no effect on which MusicBrainz release (pressing, edition, format) Lidarr matches your already-downloaded files to during import. See [FAQ → Can Lidarr prefer a specific pressing or format during import?](/lidarr/faq#can-lidarr-prefer-a-specific-pressing-or-format-during-import) for the import side of this.
{.is-info}


## Custom Formats

{#custom-formats-2}
Expand Down Expand Up @@ -211,7 +208,6 @@ Two ways to test how Lidarr will parse a release name before committing to a pro

**Via the Servarr Discord bot:** In the `#bot-spam` channel, run `/parser lidarr <release title>` (for example, `/parser lidarr Artist.Album.2022.FLAC-GROUP`). The bot replies with the same parsed breakdown. Useful for quick spot-checks without opening the UI.


# Quality

{#quality}
Expand All @@ -230,7 +226,6 @@ For audio, size limits use **kilobits per second (kbps)**. Lidarr computes a bit
> FLAC is lossless and doesn't have a consistent bitrate; its effective bitrate varies by content. The FLAC entry in quality definitions serves primarily as a file-size sanity check rather than strict bitrate enforcement.
{.is-info}


# Download Clients

{#download-clients}
Expand Down Expand Up @@ -338,7 +333,6 @@ A mapping translates a remote path (as reported by the download client) to a loc
> If both Lidarr and the download client are in Docker containers on the same host with matching volume mounts, a remote path mapping isn't needed. See [TRaSH's Remote Path Mapping guide](https://trash-guides.info/Radarr/Radarr-remote-path-mapping/) for diagnosis and setup.
{.is-info}


# Connect

{#connections}
Expand Down Expand Up @@ -368,7 +362,6 @@ Click **Add (+)** and select a connection type. Most connections share these fie

For **Custom Script** connections, see the [Custom Scripts](/lidarr/custom-scripts) page for the full list of environment variables available per event.


# Tags

{#tags}
Expand Down
6 changes: 3 additions & 3 deletions lidarr/tips-and-tricks.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Your download folder and music library root folder can't be the same location. M

Keep two locations separate:

```
```text
/data/
downloads/ ← download client writes here
music/ ← Lidarr root folder (your library)
Expand All @@ -37,7 +37,7 @@ On import, Lidarr moves (or hardlinks) files from `downloads/` into `music/`. Th

If you're running more than one download client — say, a Usenet client alongside a torrent client — give each its own subfolder under `downloads/` and set a matching category in Lidarr:

```
```text
/data/
downloads/
usenet/ ← SABnzbd / NZBGet category: "lidarr"
Expand Down Expand Up @@ -416,4 +416,4 @@ As long as the root folder paths in the backup are still valid on the destinatio
- [Metadata Troubleshooting](/lidarr/metadata-troubleshooting) — when MusicBrainz data is missing or stale
- [Import Troubleshooting](/lidarr/import-troubleshooting) — when downloads finish but don't import
- [Troubleshooting](/lidarr/troubleshooting) — general runtime issues
- [TRaSH Guides](https://trash-guides.info/) — community recipes for media server setups
- [TRaSH Guides](https://trash-guides.info/) — community recipes for media server setups
1 change: 0 additions & 1 deletion lidarr/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -420,7 +420,6 @@ In this test, look for obvious errors and run some simple checks. The trace log
![searches-indexers-and-trackers1.png](/assets/lidarr/searches-indexers-and-trackers1.png)
![searches-indexers-and-trackers2.png](/assets/lidarr/searches-indexers-and-trackers2.png)


## Common Problems

Below are some common problems.
Expand Down