Lidarr Music Management for Openclaw

A powerful music automation skill for searching, adding, and monitoring artists and albums within Lidarr.

rappo
v1.0.0
Feb 5, 2026
2
2.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install lidarr

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install lidarr using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Lidarr Music Management?

The Lidarr skill is a specialized tool designed to integrate your music library management directly into your automated workflows. By leveraging this skill, users can interact with their Lidarr instance to discover new artists, manage quality profiles such as lossless FLAC, and maintain a clean, organized music collection. It acts as a bridge between high-level user requests and the technical API requirements of Lidarr, making it a vital component for users of Openclaw Skills who want to automate their media acquisition.

Lidarr Music Management Use Cases

  • Automatically adding new artists to your collection based on name searches.
  • Managing high-quality FLAC library standards via pre-configured quality profiles.
  • Monitoring specific albums for release without adding an artist's entire discography.
  • Cleaning up music libraries by removing artists and optionally deleting their local files via Openclaw Skills commands.

How Lidarr Music Management Works

  1. The user triggers a search command to find an artist's unique MusicBrainz ID through the Lidarr API.
  2. The skill returns a list of matching artists, allowing the user to verify the correct entity.
  3. Upon selection, the skill sends a request to Lidarr to add the artist using specific quality and metadata profile IDs.
  4. The user can then list all albums associated with that artist to decide which specific items to monitor.
  5. The skill manages the monitoring status, triggering Lidarr to search for and download the requested music files automatically.

Lidarr Music Management Setup

To get started with this skill, you must have curl and jq installed on your system. Create a configuration file at ~/.clawdbot/credentials/lidarr/config.json with the following structure:

{
  "url": "http://your-lidarr-ip:8686",
  "apiKey": "your_api_key_here",
  "defaultQualityProfile": 2,
  "defaultMetadataProfile": 7
}

Verify your connection by running the config helper command:

bash scripts/lidarr.sh config

Lidarr Music Management Data Schema & Taxonomy

The skill utilizes a JSON configuration file for authentication and default behavior. Data returned from the skill is typically formatted as follows:

Parameter Description
url The network address of your Lidarr server.
apiKey The authentication token found in Lidarr Settings > General.
defaultQualityProfile The integer ID representing your preferred quality (e.g., FLAC or MP3).
defaultMetadataProfile The integer ID for metadata depth (e.g., Studio Albums or Full Discography).

All interactions within Openclaw Skills are mapped to Lidarr's internal artist and album IDs to ensure precision.

Lidarr Music Management Advanced Features

  • Support for full discography monitoring vs. studio-only releases using the --discography flag.
  • The --no-search option to add entries to the database without immediately triggering a download search.
  • Granular control over specific album monitoring to save disk space and bandwidth.
  • Integrated library maintenance tools to refresh metadata or remove content including filesystem cleanup.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins curljq
Github Stars: 0
forks: 0

Featured*