Download Cleaner
The Download Cleaner automatically removes downloads from your download client after they have finished seeding according to configurable rules. This helps manage disk space and maintain optimal seeding ratios.
These settings need a download client to be configured.
🔄Enable Download Cleaner
When enabled, the Download Cleaner will run according to the configured schedule to automatically clean completed downloads from your download client.
📅Scheduling Mode
Choose how to configure the Download Cleaner schedule:
- Basic: Simple interval-based scheduling (every X minutes/hours/seconds)
- Advanced: Full cron expression control for complex schedules
⏲️Cron Expression
Enter a valid Quartz.NET cron expression to control when the Download Cleaner runs. The example above runs every hour.
Common Cron Examples:
0 0/5 * ? * * *- Every 5 minutes0 0 * ? * * *- Every hour0 0 */6 ? * * *- Every 6 hours
🌱 Seeding Settings
Settings that control how downloads are cleaned after they finish downloading.
🗑️Delete Private Torrents
When enabled, private torrents will be deleted from the download client when they meet the cleanup criteria. Use with caution as this permanently removes the download.
Setting this to true means private torrents will be permanently deleted, potentially affecting your private tracker account by receiving H&R if the seeding requirements are not met.
📏 Seeding Rules
Categories define the cleanup rules for different types of downloads. Each category specifies when downloads should be removed based on ratio and time limits.
A download is cleaned when both Max Ratio and Min Seed Time are reached, OR when Max Seed Time is reached regardless of ratio.
Both Max Ratio and Max Seed Time cannot be disabled (-1) at the same time. At least one cleanup condition must be configured.
🏷️Category Name
The name of the download client category to apply these rules to. Must match the category name exactly as configured in your download client.
Examples:
tv-sonarrradarrlidarr
📊Max Ratio
Maximum ratio to seed before considering the download for removal. Set to -1 to disable ratio-based cleanup.
⏰Min Seed Time (hours)
Minimum time in hours to seed before removing a download that has reached the max ratio. Set to 0 to disable minimum time requirements.
⏳Max Seed Time (hours)
Maximum time in hours to seed before removing a download regardless of ratio. Set to -1 to disable time-based cleanup.
🔗 Unlinked Download Settings
Settings for managing downloads that no longer have hardlinks to media files (indicating they may no longer be needed by the *arr applications).
🔍Enable Unlinked Download Handling
Enable management of downloads that have no hardlinks remaining. This helps identify downloads that are no longer needed by your *arr applications.
If you are using Docker, make sure to mount the downloads directory the same way it is mounted for the download client. If your download client's download directory is /downloads, it should be the same for Cleanuparr.
🎯Target Category
Category to move unlinked downloads to.
🏷️Use Tag
When enabled, uses a tag instead of category for marking unlinked downloads (qBittorrent only).
📁Ignored Root Directory
Root directory to ignore when checking for unlinked downloads. Useful for cross-seed setups where you want to ignore hardlinks (even though a movie is not in Radarr anymore, it can have hardlinks from cross-seed).
/data
├── downloads
│ ├── torrents
│ └── cross-seed
├── movies
└── shows
For the example above, the ignored root directory should be set to /data/downloads.
📋Unlinked Categories
Categories to check for unlinked downloads. Only downloads in these categories will be checked for missing hardlinks.