# Lidarr

> Adds artists and albums to a Lidarr music library via command-line scripts, with support for quality and metadata profiles.

- Skill: `kbarbel640-del/lidarr` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add kbarbel640-del/lidarr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/lidarr/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Tags: Album, Artist, Flac, Lidarr, Metadata Profile, Music, Quality Profile
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/kbarbel640-del/lidarr

---


# Lidarr

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

## Setup

Create `~/.clawdbot/credentials/lidarr/config.json`:
```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
bash scripts/lidarr.sh search "Artist Name"
```
Returns numbered list with MusicBrainz links.

### 2. Check if artist exists
```bash
bash scripts/lidarr.sh exists <foreignArtistId>
```

### 3. Add artist
```bash
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
bash scripts/lidarr.sh list-artist-albums <artistId>
```
Shows all albums with their IDs and monitored status.

### 5. Monitor specific albums
```bash
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
bash scripts/lidarr.sh search "KMFDM"
```

### Check if artist exists
```bash
bash scripts/lidarr.sh exists 45074d7c-5307-44a8-854f-ae072e1622ae
```

### Add an artist (FLAC + albums only by default)
```bash
bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622ae
```

### Add with full discography
```bash
bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622ae --discography
```

### List albums for an artist
```bash
bash scripts/lidarr.sh list-artist-albums 382
```

### Monitor a specific album
```bash
bash scripts/lidarr.sh monitor-album 11116
```

### List your library
```bash
bash scripts/lidarr.sh list
```

### Refresh artist metadata
```bash
bash scripts/lidarr.sh refresh <artistId>
```

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

### Get configuration
```bash
bash scripts/lidarr.sh config
```