Skip to content

Lidarr

Lidarr integration enables lifecycle actions on music managed by Lidarr.

  1. Go to Settings → Integrations
  2. Under the Lidarr section, click Add Instance
  3. Enter:
    • Name: A label for this instance (e.g., “Main Lidarr”)
    • URL: Lidarr’s base URL (e.g., http://192.168.1.100:8686)
    • API Key: Found in Lidarr → Settings → General → API Key
  4. Click Test Connection to verify
  5. Save

You can add multiple Lidarr instances.

Librariarr matches music to Lidarr using MusicBrainz IDs:

  1. During media sync, external IDs are fetched from your media server
  2. When lifecycle rules need Lidarr data, Librariarr queries Lidarr by MusicBrainz artist ID
  3. Fallback: artist name matching

Once connected, these operations are available via lifecycle rules:

OperationDescription
DeleteRemove the artist/album from Lidarr (optionally delete files)
UnmonitorStop Lidarr from monitoring for upgrades
TagAdd a custom tag to the artist in Lidarr

The following Lidarr metadata is available for lifecycle rule conditions:

  • Quality profile: The assigned quality profile name
  • Monitored status: Whether the artist is monitored
  • Tags: Current tags on the artist
  • API keys are stored securely and never sent to the frontend
  • Connection testing uses server-side endpoints
  • All integration responses are sanitized
  • MusicBrainz ID availability depends on your media server’s metadata agent
  • Lifecycle actions require Lidarr to be reachable at execution time
  • Music matching can be less reliable than movie/series matching due to artist name variations