lidarr

name	lidarr
version	1.0.0
description	Search and add music to Lidarr. Supports artists, albums, and quality profiles (FLAC preferred).
metadata	{"openclaw":{"emoji":"🎵","requires":{"bins":["curl","jq"]}}}

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