← Back to Skills Marketplace
1550
Downloads
2
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install lidarr
Description
Search and add music to Lidarr. Supports artists, albums, and quality profiles (FLAC preferred).
README (SKILL.md)
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 \x3CforeignArtistId>
3. Add artist
bash scripts/lidarr.sh add \x3CforeignArtistId>
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 \x3CartistId>
Shows all albums with their IDs and monitored status.
5. Monitor specific albums
bash scripts/lidarr.sh monitor-album \x3CalbumId>
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 \x3CartistId>
Remove an artist
bash scripts/lidarr.sh remove \x3CartistId> # keep files
bash scripts/lidarr.sh remove \x3CartistId> --delete-files # delete files too
Get configuration
bash scripts/lidarr.sh config
Usage Guidance
This skill appears coherent and limited to controlling a Lidarr instance, but check these before installing:
- Inspect the full scripts/lidarr.sh file yourself (the provided listing was truncated) to confirm there are no unexpected network endpoints or commands in the remaining sections.
- The skill requires storing your Lidarr API key in ~/.clawdbot/credentials/lidarr/config.json; ensure that file has restrictive permissions (chmod 600) and that the configured url points to a trusted Lidarr instance on your network.
- Because the script issues HTTP requests to whatever URL you configure, do not point it at unknown or public hosts you don't control. If you suspect misuse, revoke the Lidarr API key and recreate a new one.
- If you need greater assurance, run the script in a restricted environment (container or isolated user) so the scope of access is limited.
Capability Analysis
Type: OpenClaw Skill
Name: lidarr
Version: 1.0.0
The OpenClaw Lidarr skill is benign. It correctly uses `curl` and `jq` to interact with a user-configured Lidarr API, reading credentials from the designated `~/.clawdbot/credentials/lidarr/config.json` file. User input is properly URL-encoded using `jq -sRr @uri` before being passed to `curl`, mitigating command injection risks. The `SKILL.md` provides clear instructions without any prompt injection attempts against the agent. All network activity is confined to the specified Lidarr instance, and there is no evidence of data exfiltration, malicious execution, persistence, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description ask to search/add music to Lidarr. The shipped script calls the Lidarr HTTP API (via a user-provided url and apiKey in ~/.clawdbot/credentials/lidarr/config.json) and uses only curl/jq as declared — coherent with the stated purpose.
Instruction Scope
SKILL.md instructs creating a local config file with Lidarr URL and API key and then running the included bash script. The script only reads that config file and makes HTTP calls to the configured Lidarr API endpoints; it does not read other unrelated system files or environment variables in the shown portion.
Install Mechanism
No install spec — it's instruction-only with an included script. It requires standard CLI tools (curl, jq) already declared. There are no downloads or archive extraction steps.
Credentials
No environment variables or unrelated credentials are requested. The only secret is the Lidarr API key stored in the local JSON config file, which is appropriate and proportional for a local Lidarr controller script.
Persistence & Privilege
always is false and the skill does not request system-wide changes in the visible code. There is nothing that indicates it modifies other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lidarr - After installation, invoke the skill by name or use
/lidarr - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Add and manage artists/albums in Lidarr with flexible quality and metadata profile support.
- Search for artists and view MusicBrainz links.
- Add artists (albums only or full discography) with quality profile preference (FLAC recommended).
- List and monitor albums, with options to search or just add to monitoring.
- Supports removing artists, refreshing metadata, and viewing library/configuration.
- Requires simple config file with Lidarr URL, API key, and profile IDs.
Metadata
Frequently Asked Questions
What is Lidarr?
Search and add music to Lidarr. Supports artists, albums, and quality profiles (FLAC preferred). It is an AI Agent Skill for Claude Code / OpenClaw, with 1550 downloads so far.
How do I install Lidarr?
Run "/install lidarr" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Lidarr free?
Yes, Lidarr is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Lidarr support?
Lidarr is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Lidarr?
It is built and maintained by rappo (@rappo); the current version is v1.0.0.
More Skills