Overview
What wArrden automates and which arr applications it supports.
wArrden is a scheduled job runner for media libraries. It connects to one or more arr instances, searches for monitored content that is missing or upgradeable, and handles queue entries that are stuck on known import warnings.
It is designed to run continuously as a container. Each configured instance has its own schedules, search limits, cooldowns, indexer filters, and cleanup behavior.
Supported applications
| Application | API | Queue cleanup | Missing search | Upgrade search |
|---|---|---|---|---|
| Radarr | v3 | Yes | Yes | Yes |
| Sonarr | v3 | Yes | Yes | Yes |
| Lidarr | v1 | Yes | Yes | Yes |
| Whisparr | v3, v3-eros | Yes | Yes | Yes |
How it works
- A five-field cron expression starts each enabled job.
- Search jobs fetch wanted items, discard anything still on cooldown, choose up to the configured limit, and ask the arr instance to search.
- Queue cleanup inspects warning and error messages, applies the first matching configured rule, and removes or blocklists the item when that rule is active.
- Results and summary statistics are written to the container log.
Search cooldowns are stored in /app/data/warrden.db, so the data volume should persist across container replacements.