You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b964fa1
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: lidarr/activity.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ The queue table shows the following columns by default: Status, Artist, Album Ti
31
31
### Queue statuses
32
32
33
33
| Icon | Status | Description | Resolution |
34
-
|---|---|---|---|
34
+
|---|---|---|---|
35
35
| Grey cloud | Queued | The item is waiting in the download client and hasn't started downloading yet. | Wait for the download client to start it. |
36
36
| Grey clock | Release Pending | The download is waiting for a Delay Profile timer to expire before Lidarr sends it to the download client. | Wait for the delay to pass, or adjust your Delay Profile in Settings. |
37
37
| Yellow arrow | Downloading | The item is actively downloading in the download client. | N/A. |
@@ -59,7 +59,7 @@ Each row has action icons on the right:
59
59
Click **Options** in the queue toolbar to open Table Options:
60
60
61
61
| Option | Default | Description |
62
-
|---|---|---|
62
+
|---|---|---|
63
63
| Page Size | 20 | Number of queue items shown per page. |
64
64
| Show Unknown Artist Items | On | Shows items in Lidarr's download client category that Lidarr can't match to any artist in your library (for example, removed artists or items added to the category manually). |
65
65
| Columns | (see below) | Choose which columns are visible and their display order. |
Copy file name to clipboardExpand all lines: lidarr/beets-integration.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,22 +22,22 @@ Both Lidarr and beets pull from MusicBrainz, but beets exposes more of that data
22
22
## Release and catalog identifiers
23
23
24
24
| Field | What it stores |
25
-
|---|---|
25
+
|---|---|
26
26
|`catalognum`| The release's catalog number |
27
27
|`asin`| Amazon Standard Identification Number |
28
28
|`barcode`| The release's barcode |
29
29
30
30
## Locale and script
31
31
32
32
| Field | What it stores |
33
-
|---|---|
33
+
|---|---|
34
34
|`script`| The writing system used for the release's titles |
35
35
|`language`| Release language |
36
36
37
37
## Artist naming
38
38
39
39
| Field | What it stores |
40
-
|---|---|
40
+
|---|---|
41
41
|`artist_credit`| The artist name exactly as credited on this specific release |
42
42
|`albumartist_credit`| The album artist name exactly as credited on this specific release |
43
43
@@ -62,7 +62,7 @@ Lidarr writes only the release-level disambiguation, into MusicBrainz Album Comm
62
62
Core beets fields since beets 1.5.0, not a plugin:
63
63
64
64
| Field | What it stores |
65
-
|---|---|
65
+
|---|---|
66
66
|`work`| The MusicBrainz Work title (the composition, distinct from the recording) |
67
67
|`mb_workid`| The Work's MBID |
68
68
|`work_disambig`| Disambiguation string for the work |
@@ -197,7 +197,7 @@ foreach ($dir in $albumDirs) {
197
197
## Trade-offs
198
198
199
199
|||
200
-
|---|---|
200
+
|---|---|
201
201
|**Benefit**| beets runs once at import time with any plugins you want, writing a full tag set that Lidarr wouldn't produce on its own. |
202
202
|**Benefit**| No persistent beets database to maintain or back up. |
203
203
|**Drawback**| Tags written at import time are never updated. If MusicBrainz data improves, or a plugin source updates its data (for example, updated ReplayGain values), the library files won't reflect it until you re-import or run beets manually. |
@@ -252,7 +252,7 @@ Two scenarios where the tools can conflict:
252
252
## Trade-offs
253
253
254
254
|||
255
-
|---|---|
255
+
|---|---|
256
256
|**Benefit**| beets maintains tags on an ongoing basis; as plugin data sources update, you can re-run beets to pull in new values. |
257
257
|**Benefit**| beets' persistent library enables more sophisticated queries, playlist generation, and plugin behaviour. |
258
258
|**Drawback**| Requires careful beets configuration to prevent file moves. One misconfiguration can disorganise a large library. |
|**Benefit**| No separate scheduler to maintain. Reuses Lidarr's own artist-refresh cadence as the trigger, and only runs beets against files that actually changed. |
318
318
|**Benefit**| One hook covers import, manual retag, and periodic MusicBrainz sync. Pattern 1 only covers import. |
319
319
|**Drawback**| Lidarr's write always happens first. If you want beets' choices (for example, its release-specific artist credit) to reliably win over Lidarr's canonical values, this ordering delivers that, but only after Lidarr has written its own value there first, every time. |
Copy file name to clipboardExpand all lines: lidarr/calendar.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ The Calendar page shows album releases from artists in your library, laid out we
17
17
Each release tile is color-coded to show its current status:
18
18
19
19
| Color | Meaning |
20
-
|---|---|
20
+
|---|---|
21
21
| Green | All tracks downloaded; Lidarr has a complete copy of this release. |
22
22
| Blue | Monitored and upcoming; the release date is in the future. |
23
23
| Purple | Currently downloading; the release is in the queue or was recently grabbed. |
@@ -38,7 +38,7 @@ Lidarr can expose your calendar as an iCal feed that any calendar client support
38
38
Click the **iCal Feed** button on the Calendar page to open the feed configuration dialog. The options available are:
39
39
40
40
| Field | Default | Description |
41
-
|---|---|---|
41
+
|---|---|---|
42
42
| Include Unmonitored | Off | When enabled, unmonitored album releases are included in the feed as well as monitored ones. |
43
43
| Past Days | 7 | How many days into the past the feed includes. |
44
44
| Future Days | 28 | How many days into the future the feed includes. |
@@ -56,14 +56,14 @@ The **Options** button opens the Calendar Options dialog, split into two section
56
56
**Local** (apply to this browser only):
57
57
58
58
| Option | Default | Description |
59
-
|---|---|---|
59
+
|---|---|---|
60
60
| Collapse Multiple Albums | Off | When more than one album from the same artist releases on the same day, collapse them into a single tile instead of showing each one. |
61
61
| Icon for Cutoff Unmet | Off | Show a visual indicator on release tiles where files exist but the quality cutoff hasn't been met. |
62
62
63
63
**Global** (apply across all browsers and users):
64
64
65
65
| Option | Description |
66
-
|---|---|
66
+
|---|---|
67
67
| First Day of Week | Sets whether weeks start on Sunday or Monday. |
68
68
| Week Column Header | Controls the date format shown above each day column (for example, `Tue 3/25`). |
69
69
| Time Format | Sets the time format used across the calendar (12-hour or 24-hour). |
|`lidarr_instancename`| The Lidarr instance name (set in Settings → General) |
54
54
|`lidarr_applicationurl`| The configured application URL (set in Settings → General) |
@@ -58,7 +58,7 @@ These three variables are present in every event.
58
58
Fired when Lidarr sends a release to a download client.
59
59
60
60
| Environment Variable | Details |
61
-
|---|---|
61
+
|---|---|
62
62
|`lidarr_eventtype`|`Grab`|
63
63
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
64
64
|`lidarr_artist_name`| Artist name |
@@ -89,7 +89,7 @@ Fired when Lidarr sends a release to a download client.
89
89
Fired after Lidarr has successfully imported a downloaded album into the library. `lidarr_eventtype` is `AlbumDownload` for both initial imports and upgrades.
90
90
91
91
| Environment Variable | Details |
92
-
|---|---|
92
+
|---|---|
93
93
|`lidarr_eventtype`|`AlbumDownload`|
94
94
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
95
95
|`lidarr_artist_name`| Artist name |
@@ -119,7 +119,7 @@ Fired after Lidarr has successfully imported a downloaded album into the library
119
119
Fired after Lidarr renames one or more track files for an artist.
120
120
121
121
| Environment Variable | Details |
122
-
|---|---|
122
+
|---|---|
123
123
|`lidarr_eventtype`|`Rename`|
124
124
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
125
125
|`lidarr_artist_name`| Artist name |
@@ -137,7 +137,7 @@ Fired after Lidarr renames one or more track files for an artist.
137
137
Fired after Lidarr rewrites tags on one or more track files.
138
138
139
139
| Environment Variable | Details |
140
-
|---|---|
140
+
|---|---|
141
141
|`lidarr_eventtype`|`TrackRetag`|
142
142
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
143
143
|`lidarr_artist_name`| Artist name |
@@ -170,7 +170,7 @@ Fired after Lidarr rewrites tags on one or more track files.
170
170
Fired when you add an artist to Lidarr.
171
171
172
172
| Environment Variable | Details |
173
-
|---|---|
173
+
|---|---|
174
174
|`lidarr_eventtype`|`ArtistAdd`|
175
175
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
176
176
|`lidarr_artist_title`| Artist name |
@@ -185,7 +185,7 @@ Fired when you add an artist to Lidarr.
185
185
Fired when you remove an artist from Lidarr.
186
186
187
187
| Environment Variable | Details |
188
-
|---|---|
188
+
|---|---|
189
189
|`lidarr_eventtype`|`ArtistDeleted`|
190
190
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
191
191
|`lidarr_artist_title`| Artist name |
@@ -201,7 +201,7 @@ Fired when you remove an artist from Lidarr.
201
201
Fired when you remove an album from Lidarr.
202
202
203
203
| Environment Variable | Details |
204
-
|---|---|
204
+
|---|---|
205
205
|`lidarr_eventtype`|`AlbumDeleted`|
206
206
|`lidarr_artist_id`| Internal Lidarr ID for the artist |
207
207
|`lidarr_artist_name`| Artist name |
@@ -222,7 +222,7 @@ Fired when you remove an album from Lidarr.
222
222
Fired when Lidarr detects a health check failure.
223
223
224
224
| Environment Variable | Details |
225
-
|---|---|
225
+
|---|---|
226
226
|`lidarr_eventtype`|`HealthIssue`|
227
227
|`lidarr_health_issue_level`| Severity level: `Ok`, `Notice`, `Warning`, or `Error`|
228
228
|`lidarr_health_issue_message`| Human-readable description of the issue |
@@ -234,7 +234,7 @@ Fired when Lidarr detects a health check failure.
234
234
Fired when a failing health check returns to a healthy state.
Copy file name to clipboardExpand all lines: lidarr/import-troubleshooting.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,7 +50,7 @@ Standalone track imports outside the album context use a **60% similarity** thre
50
50
The distance score is a weighted combination of how well each field matches. Lidarr adapts the weights from [beets' default configuration](https://beets.readthedocs.io/), with MusicBrainz IDs as the strongest signals:
51
51
52
52
| Signal | Weight | Notes |
53
-
|---|---|---|
53
+
|---|---|---|
54
54
|`recording_id`| 10.0 | MusicBrainz Recording MBID. If present and correct, imports almost always succeed. |
55
55
|`album_id`| 5.0 | MusicBrainz Release MBID. |
56
56
|`artist`| 3.0 | Artist name (Levenshtein distance after normalisation). |
Copy file name to clipboardExpand all lines: lidarr/library.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -72,7 +72,7 @@ When adding an artist you will set:
72
72
**Monitor** is a one-time action, applied to whatever albums Lidarr already has on file at the moment it runs, whether that's when you first add the artist, or later via the **Update Monitoring** bulk action. It does not reach forward to catch albums added to MusicBrainz afterward; that's what [Monitor New Items](#monitor-new-items) is for.
73
73
74
74
| Option | Sets monitored to true for |
75
-
|---|---|
75
+
|---|---|
76
76
|**All Albums**| Every album. |
77
77
|**Future Albums**| Albums with no file that have a release date in the future. Already-released albums, with or without a file, are unmonitored. |
78
78
|**Missing Albums**| Albums with no file, whether already released or upcoming. |
@@ -91,7 +91,7 @@ When adding an artist you will set:
91
91
**Monitor New Items** is an ongoing, artist-level setting. Unlike **Monitor** above, it doesn't run once — it fires every time a metadata refresh finds an album for this artist that isn't already in Lidarr's database.
92
92
93
93
| Option | Behavior |
94
-
|---|---|
94
+
|---|---|
95
95
|**All Albums**| Monitor every newly discovered album. |
96
96
|**New Albums**| Monitor a newly discovered album only if its release date is on or after the most recent release date Lidarr already has on file for that artist. |
97
97
|**None**| Leave newly discovered albums unmonitored. |
Copy file name to clipboardExpand all lines: lidarr/lidarr-tag-reference.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,7 +30,7 @@ Before writing, Lidarr reads the file's current tags and compares them against w
30
30
## Track and album fields
31
31
32
32
| Field | Source | Notes |
33
-
|---|---|---|
33
+
|---|---|---|
34
34
| Title | Track title ||
35
35
| Artist | Track's credited artist name ||
36
36
| Album Artist | Album's artist name ||
@@ -46,7 +46,7 @@ Before writing, Lidarr reads the file's current tags and compares them against w
46
46
## Dates
47
47
48
48
| Field | Source | Notes |
49
-
|---|---|---|
49
+
|---|---|---|
50
50
| Date | Release date of the specific release matched to this file ||
51
51
| Year | Album release year ||
52
52
| Original Release Date | Album's original release date | Distinguishes a reissue's release date from the date the album was first released. |
@@ -55,7 +55,7 @@ Before writing, Lidarr reads the file's current tags and compares them against w
55
55
## MusicBrainz identifiers
56
56
57
57
| Field | Source |
58
-
|---|---|
58
+
|---|---|
59
59
| MusicBrainz Artist Id | Track's credited artist |
60
60
| MusicBrainz Release Artist Id | Album artist |
61
61
| MusicBrainz Release Id | The matched release |
@@ -76,7 +76,7 @@ If **Embed Cover Art in Audio Files** is enabled, Lidarr embeds the album's cove
76
76
Most fields above map to the standard tag for the format in use, for example Title becomes `TIT2` in ID3v2 and `TITLE` in Vorbis comments. A handful of fields don't have a standard home in every format and get format-specific treatment:
0 commit comments