Love this project? Give it a ⭐️ and let others know!

Cleanuperr

Cleanuperr is a tool for automating the cleanup of unwanted or blocked files in Sonarr, Radarr, and supported download clients like qBittorrent. It removes incomplete or blocked downloads, updates queues, and enforces blacklists or whitelists to manage file selection. After removing blocked content, Cleanuperr can also trigger a search to replace the deleted shows/movies.

Cleanuperr was created primarily to address malicious files, such as *.lnk or *.zipx, that were getting stuck in Sonarr/Radarr and required manual intervention. Some of the reddit posts that made Cleanuperr come to life can be found here, here, here and here.

Important

Features:

• Strike system to mark stalled or downloads stuck in metadata downloading.
• Remove and block downloads that reached a maximum number of strikes.
• Remove and block downloads that have a low download speed or high estimated completion time.
• Remove downloads blocked by qBittorrent or by Cleanuperr's content blocker.
• Trigger a search for downloads removed from the *arrs.
• Clean up downloads that have been seeding for a certain amount of time.
• Notify on strike or download removal.
• Ignore certain torrent hashes, categories, tags or trackers from being processed by Cleanuperr.

Cleanuperr supports both qBittorrent's built-in exclusion features and its own blocklist-based system. Binaries for all platforms are provided, along with Docker images for easy deployment.

Quick Start

Note

1. Docker (Recommended)
   Pull the Docker image from ghcr.io/flmorg/cleanuperr:latest.

2. Unraid (for Unraid users)
   Use the Unraid Community App.

3. Manual Installation (if you're not using Docker)
   Go to Windows, Linux or MacOS.

Docs

Docs can be found here.

Cleanuperr Huntarr

Think of Cleanuperr as the janitor of your server; it keeps your download queue spotless, removes clutter, and blocks malicious files. Now imagine combining that with Huntarr, the compulsive librarian who finds missing and upgradable media to complete your collection

While Huntarr fills in the blanks and improves what you already have, Cleanuperr makes sure that only clean downloads get through. If you're aiming for a reliable and self-sufficient setup, Cleanuperr and Huntarr will take your automated media stack to another level.

➡️ Huntarr

Credits

Special thanks for inspiration go to:

• ThijmenGThN/swaparr
• ManiMatter/decluttarr
• PaeyMoopy/sonarr-radarr-queue-cleaner
• Sonarr & Radarr

Buy me a coffee

If I made your life just a tiny bit easier, consider buying me a coffee!