Sonarr

Sonarr integration enables lifecycle actions on TV series managed by Sonarr.

Setup

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

You can add multiple Sonarr instances if you run more than one.

How Matching Works

Librariarr matches series to Sonarr using TVDB IDs:

1. During media sync, external IDs (including TVDB) are fetched from your media server
2. When lifecycle rules or lookups need Sonarr data, Librariarr queries Sonarr by TVDB ID
3. If a TVDB ID is not available, Librariarr falls back to title matching

Note

For matching to work reliably, ensure your media server’s metadata agent populates TVDB IDs for your TV series. Most default metadata providers do this automatically.

Available Operations

Once connected, Librariarr can perform these operations via lifecycle rules:

Operation	Description
Delete	Remove the series from Sonarr (optionally delete files from disk)
Unmonitor	Stop Sonarr from monitoring for upgrades/new episodes
Tag	Add a custom tag to the series in Sonarr

Data from Sonarr

The following Sonarr metadata is available for lifecycle rule conditions:

• Quality profile: The assigned quality profile name
• Monitored status: Whether the series is monitored
• Tags: Current tags on the series
• Ratings: Sonarr ratings data

Security

• API keys are stored securely in the database and never sent to the frontend
• Connection testing uses a secure server-side endpoint — your API key is never sent to the browser
• All API responses containing integration data are sanitized to mask sensitive fields

Limitations

• Matching requires TVDB IDs — series without TVDB IDs can only be matched by title (less reliable)
• Lifecycle actions call Sonarr’s API in real time — if Sonarr is unreachable, actions will fail
• Sonarr API rate limits may affect bulk operations on very large libraries