A powerful automation skill for managing music libraries, artist tracking, and automated album downloads via the Lidarr REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install minerva-lidarr
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install minerva-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 Skill?
The Lidarr skill enables AI agents to interface directly with your Lidarr instance, which is a core part of the popular *arr media management suite. By leveraging this Openclaw Skills integration, developers can programmatically search for artists, monitor discographies, and trigger high-quality downloads through configured indexers and download clients. It acts as a bridge between your automated workflows and your self-hosted music server, ensuring your library stays updated with the latest releases from your favorite artists.
Lidarr Skill Use Cases
- Monitoring specific artists for new album releases automatically.
- Identifying and filling gaps in a music collection by checking for missing albums.
- Integrating music management into broader home automation or media server workflows.
- Triggering manual or automated searches for high-quality audio files based on library status.
How Lidarr Skill Works
- The skill connects to the Lidarr REST API using a provided API key and local or remote URL.
- It performs artist lookups via MusicBrainz to ensure accurate metadata mapping and unique identifiers.
- The agent retrieves quality and metadata profiles to determine how files should be handled and organized.
- It executes POST requests to add new artists or albums to the monitoring database.
- The skill can trigger system commands like MissingAlbumSearch to initiate download tasks across your indexers.
- It provides real-time status updates by querying the active download queue to monitor progress and time remaining.
Lidarr Skill Setup
To get started with this skill, you must provide your Lidarr API key and instance URL.
# 1. Store your API key in the credentials directory
echo "your_api_key_here" > ~/clawd/credentials/lidarr_api_key
# 2. Set environment variables for the session
export LIDARR_URL="http://localhost:8686"
export LIDARR_KEY=$(cat ~/clawd/credentials/lidarr_api_key)
Lidarr Skill Data Schema & Taxonomy
The skill interacts with Lidarr's structured data to manage media assets effectively:
| Data Type | Description | Key Metadata |
|---|---|---|
| Artist | Tracking entity for musicians | foreignArtistId, qualityProfileId, artistName |
| Album | Specific music release | foreignAlbumId, monitoredStatus, title |
| Queue | Active download tasks | title, status, timeleft |
| Command | System level triggers | name (e.g., MissingAlbumSearch) |
Lidarr Skill Advanced Features
- Programmatic artist lookup using foreign IDs for precise metadata matching across global databases.
- Bulk management of missing or wanted releases via Python-filtered JSON outputs for efficient data parsing.
- Multi-agent support for triggering library updates via remote command execution.
- Real-time monitoring of download client status and estimated completion times for queue items.
SKILL.md
Loading
Related Openclaw Skills
Radarr
A sophisticated movie management tool that automates the entire lifecycle of discovering, downloading, and organizing film libraries.
Windows Disk Cleaner Assistant
A secure and comprehensive Windows disk maintenance assistant that analyzes space usage and generates interactive reports for user-confirmed cleanup.
MindLog Skill for OpenClaw
MindLog acts as a dedicated memory store for OpenClaw, facilitating daily journaling prompts and automated weekly cognitive analysis via Telegram.
Sonarr
A powerful integration for managing and automating TV series discovery, library organization, and download monitoring through the Sonarr REST API.
Crypto Engine Agent Signal
Access machine-readable, paid BTC directional signals through a secure Tempo MPP-enabled workflow.
Super Market Research
A comprehensive market intelligence skill for AI agents to conduct evidence-based sizing, competitor mapping, and demand validation.
Featured*
