Skip to content

Conversation

@vikingnope
Copy link
Contributor

Summary

Adds two automation services to improve media management and download queue maintenance.

What These Services Do

Recyclarr

Automated Quality Profile Management

Recyclarr automatically syncs quality profiles, custom formats, and quality definitions from TRaSH Guides to your Radarr and Sonarr instances. Instead of manually configuring quality settings, Recyclarr keeps them updated with community-recommended best practices.

Why it's useful:

  • No manual quality profile configuration needed
  • Automatically applies TRaSH Guides recommendations
  • Keeps quality settings up-to-date across all your *arr apps
  • Runs automatically every 24 hours

Cleanuparr

Intelligent Download Queue Cleanup & Malware Protection

Cleanuparr automatically monitors your download queues and removes problematic downloads using a smart strike system. It handles failed imports, stalled downloads, slow torrents, and blocks malicious files before they cause issues.

Why it's useful:

  • Prevents malware - Blocks known malicious file patterns (*.lnk, *.zipx, etc.) using community blocklists
  • Cleans stuck downloads - Removes downloads that fail to import, stall, or download too slowly
  • Auto-replacement - Triggers automatic searches for better releases when bad ones are removed
  • Saves disk space - Manages seeding and removes completed downloads based on your rules
  • Detects orphaned files - Finds downloads no longer referenced by your *arr apps
  • Private tracker safe - Built-in protections to avoid ratio/seeding requirement issues

Changes

Docker Configuration

  • Added recyclarr and cleanuparr services to docker-compose.yml
  • Fixed network assignments and environment variables
  • Added Traefik integration with basic auth for Cleanuparr web UI

Documentation

  • Complete setup guides for both services with step-by-step instructions
  • Detailed configuration for Cleanuparr's three modules (Queue Cleaner, Malware Blocker, Download Cleaner)
  • Example Recyclarr configuration with TRaSH Guides integration
  • Updated DNS records and service lists
  • Configured for minimal/no seeding (legal compliance)

Environment

  • Added SUB_DOMAIN_CLEANUPARR=cleanuparr to .env

Access

  • Recyclarr: No web UI (runs automatically)
  • Cleanuparr: cleanuparr.domain.com (protected with basic auth)

Related Links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant