Categories
self-hosted media-server automation download-manager media-automation servarr torrent-managementStars
Forks
Watchers
Developer links
Cleanuparr
Stalled torrents, malware-laced archives, and failed imports can quietly paralyze an automated media server, and Cleanuparr eliminates those bottlenecks as an autonomous download queue manager and library seeker for the entire Servarr ecosystem. Connecting directly to Sonarr, Radarr, Lidarr, Readarr, Whisparr, Sportarr, and LazyLibrarian alongside qBittorrent, Transmission, Deluge, rTorrent, uTorrent, and SABnzbd, its configurable Queue Cleaner tracks slow transfers, stuck metadata downloads, and import failures using a strike system. Once a problematic download reaches its strike threshold or triggers the Malware Blocker against deceptive .lnk and .zipx payloads, Cleanuparr purges the offending files, blocklists the release, and instructs the media manager to search for a clean replacement. Beyond defensive queue hygiene, the built-in Seeker proactively searches your libraries for missing episodes or movies, hunts for Cutoff Unmet quality upgrades, and tracks Custom Format score distributions over time. Storage administrators can also enforce seeding duration limits, clean up orphaned torrents without breaking active cross-seed hardlinks, and quarantine unclaimed directory files before they consume disk capacity. A live web dashboard visualizes manual intervention alerts, strike histories, and searchable application logs while dispatching instant notifications through Apprise, Discord, Gotify, Notifiarr, Ntfy, Pushover, and Telegram. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. GPL-3.0 licensed.
Benefits
- Automated Strike-Based Download Queue Hygiene
- Monitors Sonarr, Radarr, Lidarr, Readarr, Whisparr, Sportarr, and LazyLibrarian queues on scheduled intervals, assigning strikes to stalled transfers, slow downloads, and failed imports before automatically removing and blocklisting repeat offenders.
- Proactive Malware and Payload Blocking
- Inspects torrent file lists across qBittorrent, Transmission, Deluge, rTorrent, and uTorrent against strict community blocklists and extension whitelists to purge malicious .lnk or .zipx files before media import occurs.
- Intelligent Missing and Quality Upgrade Seeker
- Triggers immediate replacement searches after bad downloads are removed, runs scheduled searches for missing library items and Cutoff Unmet releases, and charts Custom Format score improvements across your media collection.
- Cross-Seed Aware Orphaned Storage Cleanup
- Reclaims disk space by pruning torrents that exceed seeding duration thresholds, removing unreferenced downloads while preserving active cross-seed hardlinks, and quarantining unclaimed files found in download directories.
Features
- Multi-Instance Servarr API Integration
- Connects simultaneously to multiple Sonarr v4, Radarr v6, Lidarr v3, Readarr v0.4, Whisparr v2/v3, Sportarr, and LazyLibrarian instances with per-application strike overrides.
- Malware Pattern Blocklist Engine
- Evaluates torrent contents against configurable strict or permissive malware pattern lists and file extension whitelists, protecting automated pipelines from trojan archives and fake video executables.
- Custom Format Score Seeker
- Tracks Custom Format score distributions across connected libraries and schedules automated upgrade searches via Quartz.NET jobs until items reach their target quality profile cutoffs.
- Cross-Seed Safe Torrent Pruner
- Manages seeding timers and hardlink checks across qBittorrent, Transmission, Deluge, rTorrent, uTorrent, and SABnzbd while honoring ignore rules for specific hashes, categories, tags, or trackers.
- SignalR Real-Time Activity Dashboard
- Streams live application logs, strike tallies, audit events, and upgrade metrics over SignalR WebSockets inside an Angular 22 web interface secured with OIDC and two-factor authentication.
- Multi-Provider Event Notification System
- Dispatches granular webhook and push alerts for issued strikes, purged downloads, and triggered replacement searches via Apprise, Discord, Gotify, Notifiarr, Ntfy, Pushover, and Telegram.