โ† Back to Search & Research
Search & Research by @rappo

lidarr

Search and add music to Lidarr

0
Source Code

Lidarr

Add music (artists and albums) to your Lidarr library.

Setup

Create ~/.clawdbot/credentials/lidarr/config.json:

{
  "url": "http://192.168.1.50:8686",
  "apiKey": "efbd6c29db184911a7b0f4707ae8f10f",
  "defaultQualityProfile": 2,
  "defaultMetadataProfile": 7
}
  • defaultQualityProfile: Quality profile ID (FLAC, MP3, etc. โ€” run config to see options)
  • defaultMetadataProfile: Metadata profile ID (albums only, discography, etc. โ€” run config to see options)

Quality Profiles

Typically you'll want FLAC:

  • Lossless (FLAC)
  • Lossless 24bit (FLAC 24-bit)

Metadata Profiles

  • Albums only (recommended) โ€” just studio albums
  • Standard โ€” albums + some extras
  • Discography / Everything โ€” all releases

Workflow

1. Search for an artist

bash scripts/lidarr.sh search "Artist Name"

Returns numbered list with MusicBrainz links.

2. Check if artist exists

bash scripts/lidarr.sh exists <foreignArtistId>

3. Add artist

bash scripts/lidarr.sh add <foreignArtistId>

If artist already exists, this will monitor them instead of failing.

Options:

  • --discography โ€” add full discography instead of albums only
  • --no-search โ€” don't search immediately

4. List albums for an artist

bash scripts/lidarr.sh list-artist-albums <artistId>

Shows all albums with their IDs and monitored status.

5. Monitor specific albums

bash scripts/lidarr.sh monitor-album <albumId>

Monitor and optionally search for a specific album.

Options:

  • --no-search โ€” monitor but don't search yet

Commands

Search for artists

bash scripts/lidarr.sh search "KMFDM"

Check if artist exists

bash scripts/lidarr.sh exists 45074d7c-5307-44a8-854f-ae072e1622ae

Add an artist (FLAC + albums only by default)

bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622ae

Add with full discography

bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622ae --discography

List albums for an artist

bash scripts/lidarr.sh list-artist-albums 382

Monitor a specific album

bash scripts/lidarr.sh monitor-album 11116

List your library

bash scripts/lidarr.sh list

Refresh artist metadata

bash scripts/lidarr.sh refresh <artistId>

Remove an artist

bash scripts/lidarr.sh remove <artistId>              # keep files
bash scripts/lidarr.sh remove <artistId> --delete-files  # delete files too

Get configuration

bash scripts/lidarr.sh config