What is Cleanuparr?

Cleanuparr is an automation tool that monitors your Sonarr and Radarr download queues, detects stalled or blocked downloads, removes them, blacklists the bad release, and triggers a fresh search — all without manual intervention. It also enforces queue rules: file blacklists/whitelists, malware filtering on incoming downloads, and queue size limits.

Features

• 🚫 Stalled download detection — removes downloads that haven't progressed past a configurable threshold
• 🛡️ Blacklist enforcement — removes downloads matching banned patterns, file types, or release groups
• 🔄 Auto-replacement — triggers Sonarr/Radarr to search for an alternative after blacklisting a bad release
• 📦 Queue size limits — keeps your download queue from ballooning during indexer outages
• 🔗 qBittorrent / SABnzbd / NZBGet support — works with all the common download clients
• 📊 Per-arr rules — different cleanup policies for Sonarr vs Radarr vs Lidarr

Cleanuparr in Your Media Stack

• 📺 Sonarr / Radarr / Lidarr — monitors and cleans the download queues
• 📥 qBittorrent / SABnzbd / NZBGet — detects stalled or unhealthy torrents/NZBs
• 🔍 Prowlarr — works alongside Prowlarr's indexer health monitoring

Why ElfHosted?

Self-hosting Cleanuparr requires API tokens for every arr app and download client you want it to monitor — a typical setup means six or seven API keys configured correctly in Cleanuparr's YAML config. Get any one wrong and Cleanuparr silently skips that service. ElfHosted ships Cleanuparr pre-wired to your Sonarr, Radarr, Lidarr, qBittorrent, and SABnzbd instances — no API tokens to copy across services.

• 🔗 Pre-wired to your arr stack — no API token configuration
• 🚀 No Docker setup — no YAML config to maintain
• 🔄 Always up-to-date — ElfHosted ships upstream releases automatically

FAQ

Why not just use Sonarr's built-in queue cleanup?
Sonarr's native cleanup is basic. Cleanuparr adds blacklist patterns, file-type filtering, malware detection, and cross-app coordination that Sonarr's settings don't offer.

Will Cleanuparr remove downloads I'm still seeding?
It checks state before acting — only stalled or blocked downloads are removed. Healthy seeds are left alone unless they match an explicit blacklist rule.