Skip to main content

Malware Blocker

The Malware Blocker automatically blocks or removes downloads from your download client based on configurable blocklists. This helps prevent unwanted content from being downloaded and manages content filtering across your *arr applications.

⚠️Important

These settings need a download client to be configured.

🔄Enable Malware Blocker

When enabled, the Malware Blocker will run according to the configured schedule to automatically block or remove downloads based on the configured blocklists.

📅Scheduling Mode

Choose how to configure the Malware Blocker 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 Malware Blocker runs.

Common Cron Examples:

  • 0 0/5 * ? * * * - Every 5 minutes
  • 0 0 * ? * * * - Every hour
  • 0 0 */6 ? * * * - Every 6 hours

🔒Ignore Private

When enabled, private torrents will be skipped from being processed during content blocking.

🗑️Delete Private

When enabled, private torrents that match blocklist criteria will be deleted from the download client. Use with extreme caution as this permanently removes the download.

🚨Warning

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.

🦠Delete Known Malware

When enabled, downloads that match known malware patterns will be automatically deleted from the download client.

Malware Detection Source:

  • List is automatically fetched from: https://cleanuparr.pages.dev/static/known_malware_file_name_patterns
  • Updates automatically every 5 minutes
  • Contains filename patterns known to be associated with malware
🚨Warning

This feature permanently deletes downloads that match malware patterns. While the patterns are carefully curated, false positives are possible. Monitor logs carefully when first enabling this feature.

📋 Arr Service Settings

Configure blocklists for each *arr application. Each service can have its own blocklist configuration.

✅Enable Blocklist

When enabled, the Malware Blocker will use the configured blocklist to filter content.

📂Blocklist Path

Path to the blocklist file or URL. This can be a local file path or a remote URL that will be fetched automatically.

Examples:

  • /config/sonarr-blocklist.txt
  • https://example.com/blocklist.txt

Automatic Reload Intervals:

  • Cleanuparr Official Lists (cleanuparr.pages.dev): Every 5 minutes
  • Other Remote URLs: Every 4 hours
  • Local Files: Every 5 minutes

The blocklists support the following types of patterns:

*example            // file name ends with "example"
example*            // file name starts with "example"
*example*           // file name has "example" in the name
example             // file name is exactly the word "example"
regex:<ANY_REGEX>   // regex that needs to be marked at the start of the line with "regex:"
tip

Available blocklists that can be used with Sonarr and Radarr:

  • http://cleanuparr.pages.dev/static/blacklist
  • http://cleanuparr.pages.dev/static/blacklist_permissive
  • http://cleanuparr.pages.dev/static/whitelist
  • http://cleanuparr.pages.dev/static/whitelist_with_subtitles

🎭Blocklist Type

Controls how the blocklist is interpreted:

  • Blacklist: Files matching any pattern in the list will be blocked.
  • Whitelist: Only files matching patterns in the list will be allowed.