lidarr

What This Skill Does

The Lidarr skill enables OpenClaw to interact directly with your Lidarr music collection manager. It provides a comprehensive command-line interface for managing your musical library, from initial discovery to granular control over quality and metadata profiles. By integrating with MusicBrainz, this agent can search for artists, add them to your library, and configure monitoring settings to ensure your collection meets your specific quality requirements—such as prioritizing FLAC or 24-bit audio formats. Whether you want to add a single album or a full artist discography, this skill automates the administrative overhead of maintaining a high-fidelity digital music library.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/rappo/lidarr. Once installed, you must configure your credentials by creating the file ~/.clawdbot/credentials/lidarr/config.json. Populate this file with your Lidarr server's URL and API key, and define your preferred quality and metadata profile IDs. You can discover your specific environment's profile IDs by running the bash scripts/lidarr.sh config command after setup is complete.

Use Cases

This skill is ideal for music enthusiasts and audiophiles who maintain local media servers. Common use cases include: 1. Searching for new artists via MusicBrainz and automatically adding them to your library with standardized quality settings. 2. Auditing existing artist libraries to monitor previously unadded albums. 3. Automating the addition of large discographies without manual web interface navigation. 4. Managing disk space and library organization by toggling monitoring for specific albums or removing artists while keeping existing media files intact.

Example Prompts

1. "Find KMFDM, check if they are in my library, and add them using my default quality settings."
2. "List all albums for artist ID 382 and monitor the album with ID 11116."
3. "Refresh the metadata for my existing artists to ensure all album data is up to date."

Tips & Limitations

Always verify your profile IDs using the config command before initiating large batch adds to ensure media is saved in your preferred codec. Note that while this skill can remove artists, it requires an explicit flag to delete physical files from your disk; by default, it only removes the entry from the Lidarr database. Ensure your Lidarr server is reachable from the machine where OpenClaw is running, as network-level connectivity is required for API communication.