Skip to content

Commit b964fa1

Browse files
[pre-commit.ci] auto fixes from pre-commit.com hooks
for more information, see https://pre-commit.ci
1 parent 5503a93 commit b964fa1

20 files changed

Lines changed: 81 additions & 81 deletions

‎lidarr/activity.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The queue table shows the following columns by default: Status, Artist, Album Ti
3131
### Queue statuses
3232

3333
| Icon | Status | Description | Resolution |
34-
|---|---|---|---|
34+
| --- | --- | --- | --- |
3535
| 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. |
3636
| 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. |
3737
| 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:
5959
Click **Options** in the queue toolbar to open Table Options:
6060

6161
| Option | Default | Description |
62-
|---|---|---|
62+
| --- | --- | --- |
6363
| Page Size | 20 | Number of queue items shown per page. |
6464
| 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). |
6565
| Columns | (see below) | Choose which columns are visible and their display order. |

‎lidarr/beets-integration.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,22 +22,22 @@ Both Lidarr and beets pull from MusicBrainz, but beets exposes more of that data
2222
## Release and catalog identifiers
2323

2424
| Field | What it stores |
25-
|---|---|
25+
| --- | --- |
2626
| `catalognum` | The release's catalog number |
2727
| `asin` | Amazon Standard Identification Number |
2828
| `barcode` | The release's barcode |
2929

3030
## Locale and script
3131

3232
| Field | What it stores |
33-
|---|---|
33+
| --- | --- |
3434
| `script` | The writing system used for the release's titles |
3535
| `language` | Release language |
3636

3737
## Artist naming
3838

3939
| Field | What it stores |
40-
|---|---|
40+
| --- | --- |
4141
| `artist_credit` | The artist name exactly as credited on this specific release |
4242
| `albumartist_credit` | The album artist name exactly as credited on this specific release |
4343

@@ -62,7 +62,7 @@ Lidarr writes only the release-level disambiguation, into MusicBrainz Album Comm
6262
Core beets fields since beets 1.5.0, not a plugin:
6363

6464
| Field | What it stores |
65-
|---|---|
65+
| --- | --- |
6666
| `work` | The MusicBrainz Work title (the composition, distinct from the recording) |
6767
| `mb_workid` | The Work's MBID |
6868
| `work_disambig` | Disambiguation string for the work |
@@ -197,7 +197,7 @@ foreach ($dir in $albumDirs) {
197197
## Trade-offs
198198

199199
| | |
200-
|---|---|
200+
| --- | --- |
201201
| **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. |
202202
| **Benefit** | No persistent beets database to maintain or back up. |
203203
| **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:
252252
## Trade-offs
253253

254254
| | |
255-
|---|---|
255+
| --- | --- |
256256
| **Benefit** | beets maintains tags on an ongoing basis; as plugin data sources update, you can re-run beets to pull in new values. |
257257
| **Benefit** | beets' persistent library enables more sophisticated queries, playlist generation, and plugin behaviour. |
258258
| **Drawback** | Requires careful beets configuration to prevent file moves. One misconfiguration can disorganise a large library. |
@@ -313,7 +313,7 @@ $dir = Split-Path -Parent $env:lidarr_trackfile_path
313313
## Trade-offs
314314

315315
| | |
316-
|---|---|
316+
| --- | --- |
317317
| **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. |
318318
| **Benefit** | One hook covers import, manual retag, and periodic MusicBrainz sync. Pattern 1 only covers import. |
319319
| **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. |

‎lidarr/calendar.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The Calendar page shows album releases from artists in your library, laid out we
1717
Each release tile is color-coded to show its current status:
1818

1919
| Color | Meaning |
20-
|---|---|
20+
| --- | --- |
2121
| Green | All tracks downloaded; Lidarr has a complete copy of this release. |
2222
| Blue | Monitored and upcoming; the release date is in the future. |
2323
| 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
3838
Click the **iCal Feed** button on the Calendar page to open the feed configuration dialog. The options available are:
3939

4040
| Field | Default | Description |
41-
|---|---|---|
41+
| --- | --- | --- |
4242
| Include Unmonitored | Off | When enabled, unmonitored album releases are included in the feed as well as monitored ones. |
4343
| Past Days | 7 | How many days into the past the feed includes. |
4444
| 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
5656
**Local** (apply to this browser only):
5757

5858
| Option | Default | Description |
59-
|---|---|---|
59+
| --- | --- | --- |
6060
| 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. |
6161
| Icon for Cutoff Unmet | Off | Show a visual indicator on release tiles where files exist but the quality cutoff hasn't been met. |
6262

6363
**Global** (apply across all browsers and users):
6464

6565
| Option | Description |
66-
|---|---|
66+
| --- | --- |
6767
| First Day of Week | Sets whether weeks start on Sunday or Monday. |
6868
| Week Column Header | Controls the date format shown above each day column (for example, `Tue 3/25`). |
6969
| Time Format | Sets the time format used across the calendar (12-hour or 24-hour). |

‎lidarr/custom-scripts.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ A custom script can be any executable accessible by the user Lidarr is running a
1919
Lidarr writes script output to the log files:
2020

2121
| Output | Log level | Log file |
22-
|---|---|---|
22+
| --- | --- | --- |
2323
| `stdout` | `Debug` | `config/logs/Lidarr.debug.txt` |
2424
| `stderr` | `Error` | `config/logs/Lidarr.txt` |
2525
| Script trigger | `Trace` | `config/logs/Lidarr.trace.txt` |
@@ -48,7 +48,7 @@ Lidarr passes data to your script through environment variables. The variables a
4848
These three variables are present in every event.
4949

5050
| Environment Variable | Details |
51-
|---|---|
51+
| --- | --- |
5252
| `lidarr_eventtype` | The event name: `Grab`, `AlbumDownload`, `Rename`, `TrackRetag`, `ArtistAdd`, `ArtistDeleted`, `AlbumDeleted`, `HealthIssue`, `HealthRestored`, `ApplicationUpdate`, `Test` |
5353
| `lidarr_instancename` | The Lidarr instance name (set in Settings → General) |
5454
| `lidarr_applicationurl` | The configured application URL (set in Settings → General) |
@@ -58,7 +58,7 @@ These three variables are present in every event.
5858
Fired when Lidarr sends a release to a download client.
5959

6060
| Environment Variable | Details |
61-
|---|---|
61+
| --- | --- |
6262
| `lidarr_eventtype` | `Grab` |
6363
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
6464
| `lidarr_artist_name` | Artist name |
@@ -89,7 +89,7 @@ Fired when Lidarr sends a release to a download client.
8989
Fired after Lidarr has successfully imported a downloaded album into the library. `lidarr_eventtype` is `AlbumDownload` for both initial imports and upgrades.
9090

9191
| Environment Variable | Details |
92-
|---|---|
92+
| --- | --- |
9393
| `lidarr_eventtype` | `AlbumDownload` |
9494
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
9595
| `lidarr_artist_name` | Artist name |
@@ -119,7 +119,7 @@ Fired after Lidarr has successfully imported a downloaded album into the library
119119
Fired after Lidarr renames one or more track files for an artist.
120120

121121
| Environment Variable | Details |
122-
|---|---|
122+
| --- | --- |
123123
| `lidarr_eventtype` | `Rename` |
124124
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
125125
| `lidarr_artist_name` | Artist name |
@@ -137,7 +137,7 @@ Fired after Lidarr renames one or more track files for an artist.
137137
Fired after Lidarr rewrites tags on one or more track files.
138138

139139
| Environment Variable | Details |
140-
|---|---|
140+
| --- | --- |
141141
| `lidarr_eventtype` | `TrackRetag` |
142142
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
143143
| `lidarr_artist_name` | Artist name |
@@ -170,7 +170,7 @@ Fired after Lidarr rewrites tags on one or more track files.
170170
Fired when you add an artist to Lidarr.
171171

172172
| Environment Variable | Details |
173-
|---|---|
173+
| --- | --- |
174174
| `lidarr_eventtype` | `ArtistAdd` |
175175
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
176176
| `lidarr_artist_title` | Artist name |
@@ -185,7 +185,7 @@ Fired when you add an artist to Lidarr.
185185
Fired when you remove an artist from Lidarr.
186186

187187
| Environment Variable | Details |
188-
|---|---|
188+
| --- | --- |
189189
| `lidarr_eventtype` | `ArtistDeleted` |
190190
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
191191
| `lidarr_artist_title` | Artist name |
@@ -201,7 +201,7 @@ Fired when you remove an artist from Lidarr.
201201
Fired when you remove an album from Lidarr.
202202

203203
| Environment Variable | Details |
204-
|---|---|
204+
| --- | --- |
205205
| `lidarr_eventtype` | `AlbumDeleted` |
206206
| `lidarr_artist_id` | Internal Lidarr ID for the artist |
207207
| `lidarr_artist_name` | Artist name |
@@ -222,7 +222,7 @@ Fired when you remove an album from Lidarr.
222222
Fired when Lidarr detects a health check failure.
223223

224224
| Environment Variable | Details |
225-
|---|---|
225+
| --- | --- |
226226
| `lidarr_eventtype` | `HealthIssue` |
227227
| `lidarr_health_issue_level` | Severity level: `Ok`, `Notice`, `Warning`, or `Error` |
228228
| `lidarr_health_issue_message` | Human-readable description of the issue |
@@ -234,7 +234,7 @@ Fired when Lidarr detects a health check failure.
234234
Fired when a failing health check returns to a healthy state.
235235

236236
| Environment Variable | Details |
237-
|---|---|
237+
| --- | --- |
238238
| `lidarr_eventtype` | `HealthRestored` |
239239
| `lidarr_health_restored_level` | Previous severity level |
240240
| `lidarr_health_restored_message` | Description of the check that recovered |
@@ -246,7 +246,7 @@ Fired when a failing health check returns to a healthy state.
246246
Fired after Lidarr updates itself to a new version.
247247

248248
| Environment Variable | Details |
249-
|---|---|
249+
| --- | --- |
250250
| `lidarr_eventtype` | `ApplicationUpdate` |
251251
| `lidarr_update_message` | Update changelog message |
252252
| `lidarr_update_newversion` | Version that was just installed |

‎lidarr/environment-variables.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ Branch=master
145145
### Available Keys
146146

147147
| Key | Description | Example |
148-
|-----|-------------|---------|
148+
| ----- | ------------- | --------- |
149149
| `PackageVersion` | Custom package version identifier | `1.0.0-custom` |
150150
| `PackageAuthor` | Package maintainer name | `Community Package` |
151151
| `PackageGlobalMessage` | Message displayed in UI | `Custom build for Debian 11` |
@@ -157,7 +157,7 @@ Branch=master
157157
### UpdateMethod Values
158158

159159
| Value | Numeric | Description | Use Case |
160-
|-------|---------|-------------|----------|
160+
| ------- | --------- | ------------- | ---------- |
161161
| `BuiltIn` | 0 | Default built-in updater | Standard installations |
162162
| `Script` | 1 | Updates via custom script | Advanced custom setups |
163163
| `External` | 10 | Updates managed externally | Package managers, Docker |

‎lidarr/faq.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ A few common causes:
7474
Lidarr supports three prefixes for direct MBID lookup. All three work the same way and are case-insensitive:
7575

7676
| Prefix | Example |
77-
|---|---|
77+
| --- | --- |
7878
| `lidarr:` | `lidarr:9255f594-b912-4bdf-87a2-ada04502a459` |
7979
| `lidarrid:` | `lidarrid:9255f594-b912-4bdf-87a2-ada04502a459` |
8080
| `mbid:` | `mbid:9255f594-b912-4bdf-87a2-ada04502a459` |

‎lidarr/import-troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Standalone track imports outside the album context use a **60% similarity** thre
5050
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:
5151

5252
| Signal | Weight | Notes |
53-
|---|---|---|
53+
| --- | --- | --- |
5454
| `recording_id` | 10.0 | MusicBrainz Recording MBID. If present and correct, imports almost always succeed. |
5555
| `album_id` | 5.0 | MusicBrainz Release MBID. |
5656
| `artist` | 3.0 | Artist name (Levenshtein distance after normalisation). |

‎lidarr/library.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ When adding an artist you will set:
7272
**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.
7373

7474
| Option | Sets monitored to true for |
75-
|---|---|
75+
| --- | --- |
7676
| **All Albums** | Every album. |
7777
| **Future Albums** | Albums with no file that have a release date in the future. Already-released albums, with or without a file, are unmonitored. |
7878
| **Missing Albums** | Albums with no file, whether already released or upcoming. |
@@ -91,7 +91,7 @@ When adding an artist you will set:
9191
**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.
9292

9393
| Option | Behavior |
94-
|---|---|
94+
| --- | --- |
9595
| **All Albums** | Monitor every newly discovered album. |
9696
| **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. |
9797
| **None** | Leave newly discovered albums unmonitored. |

‎lidarr/lidarr-tag-reference.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Before writing, Lidarr reads the file's current tags and compares them against w
3030
## Track and album fields
3131

3232
| Field | Source | Notes |
33-
|---|---|---|
33+
| --- | --- | --- |
3434
| Title | Track title | |
3535
| Artist | Track's credited artist name | |
3636
| Album Artist | Album's artist name | |
@@ -46,7 +46,7 @@ Before writing, Lidarr reads the file's current tags and compares them against w
4646
## Dates
4747

4848
| Field | Source | Notes |
49-
|---|---|---|
49+
| --- | --- | --- |
5050
| Date | Release date of the specific release matched to this file | |
5151
| Year | Album release year | |
5252
| 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
5555
## MusicBrainz identifiers
5656

5757
| Field | Source |
58-
|---|---|
58+
| --- | --- |
5959
| MusicBrainz Artist Id | Track's credited artist |
6060
| MusicBrainz Release Artist Id | Album artist |
6161
| 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
7676
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:
7777

7878
| Field | ID3v2 (MP3) | Vorbis comments (FLAC, Ogg) |
79-
|---|---|---|
79+
| --- | --- | --- |
8080
| Media Format | `TMED` | `MEDIA` |
8181
| Date | `TDRC` (ID3v2.4) or `TYER`/`TDAT` (ID3v2.3) | `DATE` |
8282
| Original Release Date | `TDOR` (ID3v2.4) or `TORY` (ID3v2.3, year only) | `ORIGINALDATE` and `ORIGINALYEAR` |

‎lidarr/metadata-troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,7 @@ To add a Spotify relationship on MusicBrainz, open the release and go to **Edit*
212212
## Retry or wait
213213

214214
| Situation | Action |
215-
|---|---|
215+
| --- | --- |
216216
| You just submitted an edit at MusicBrainz | Wait ~3 hours, then **Refresh Artist** in Lidarr |
217217
| You just uploaded cover art to the Cover Art Archive | Allow days, not hours — covers propagate slower than metadata |
218218
| A release status was `unknown` and you changed it | Wait ~3 hours after the edit's visible on MusicBrainz, then **Refresh Artist** |

0 commit comments

Comments
 (0)