- 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. — runconfigto see options)defaultMetadataProfile: Metadata profile ID (albums only, discography, etc. — runconfigto 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-ae072e1622aeAdd an artist (FLAC + albums only by default)
bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622aeAdd with full discography
bash scripts/lidarr.sh add 45074d7c-5307-44a8-854f-ae072e1622ae --discographyList albums for an artist
bash scripts/lidarr.sh list-artist-albums 382Monitor a specific album
bash scripts/lidarr.sh monitor-album 11116List your library
bash scripts/lidarr.sh listRefresh 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 tooGet configuration
bash scripts/lidarr.sh config