wArrden makes it easy to maintain your Radarr and Sonarr libraries by finding missing or upgradeable content, as well as detecting and clearing stuck imports from the queue.
Important
This repository's GitHub mirror is for reference only. Please submit bug reports and feature requests to our official Forgejo repository.
Tip
The config.example.yaml file can look overwhelming, but you don't need to understand every option to get started. Just add your arr URL and API key, then enable the instance — the defaults handle the rest.
-
Download
compose.yaml:curl -O https://code.neureka.dev/warrden/warrden/raw/branch/main/compose.yaml -
Download the example config as
config.yaml, then edit it with your Sonarr/Radarr URLs and API keys:curl -o config.yaml https://code.neureka.dev/warrden/warrden/raw/branch/main/config.example.yaml -
Start the container:
docker compose up -d
| Command | Description |
|---|---|
docker exec warrden clear-missing [instance] |
Clears all missing search cooldowns. If instance is omitted, clears across all instances. |
docker exec warrden clear-upgrades [instance] |
Clears all upgrade search cooldowns. If instance is omitted, clears across all instances. |
wArrden supports multiple instances of each arr type, so you can manage separate libraries (movies, series, anime, music) independently with their own schedules and cooldowns.
| Supported | API | Queue Cleanup | Missing Search | Upgrade Search |
|---|---|---|---|---|
| Radarr | v3 |
✔️ | ✔️ | ✔️ |
| Sonarr | v3 |
✔️ | ✔️ | ✔️ |
| Lidarr | v1 |
✔️ | ✔️ | ✔️ |
| Whisparr | v3, v3-eros |
✔️ | ✔️ | ✔️ |
Periodically searches for monitored content that has never been downloaded. Limits the number of searches per run and ensures the same item isn't re-searched too often.
Periodically searches for monitored content that already exists on disk but has a better custom format score. Uses the same limits and cooldown behavior as Missing Search.
Detects stuck imports caused by common errors (wrong episode, not an upgrade, sample, corrupt file) and removes or blocklists them so the same release won't download again.
Radarr and Sonarr primarily rely on RSS feeds to detect newly uploaded releases every 15 minutes. While this works well for new uploads, many users assume it also continuously searches and reevaluates their entire library — it does not.
This creates a few common gaps in automation:
- If your server, indexers, or download clients are offline for a period of time, releases uploaded during that window may be missed entirely.
- Adding new indexers later does not retroactively search for older missing or upgradeable content. Only newly uploaded releases seen through RSS are picked up.
- Changes to Custom Formats (CFs) or scoring rules do not trigger automatic upgrades for existing media. Improved scoring only applies to future RSS releases.
Over time, this can leave libraries with permanently missing content or media that no longer matches your preferred quality and scoring standards.
wArrden fills those gaps by periodically rechecking your library and automating the cleanup work that would otherwise require manual intervention.