Mediacleanuparr
Prune your Radarr and Sonarr libraries by TMDb audience rating, with a mandatory dry run.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
40/100 Fair
- Maintained
- 60last commit 153 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 26 days ago
- GitHub stars
- 3
- Open issues
- 0
- Last commit
- 2026-06-21
- License
- MIT
- Activity
- stale
Checked 8 days ago - source: GitHub (tophat17/Mediacleanuparr)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- First run After the container starts, open the web UI to set your Radarr and Sonarr URLs/API keys, the required TMDb API key, your rating threshold, and the safety switches (Overseerr/Jellyseerr sync is optional). Settings persist in /config, and the app runs in dry-run-only mode by default until you confirm a delete. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Does Mediacleanuparr delete files automatically on its first run?
No, it defaults to dry-run-only. It shows an estimated cleanup and requires you to review the list and type DELETE before anything is removed.
Which external API is required for rating-based cleanup?
TMDb is required to provide audience ratings. Radarr and Sonarr are the media sources it prunes, while Overseerr or Jellyseerr sync is optional.
Can Mediacleanuparr stop Overseerr or Jellyseerr from re-requesting deleted titles?
Yes, optional Overseerr or Jellyseerr sync can be enabled so deletions stop being auto-requeued.
Does the empty/0-byte cleanup remove orphaned empty folders?
Yes, the empty/0-byte cleanup toggle removes empty entries that are also below your threshold, plus orphaned empty folders.
Can specific titles be protected from future scans?
Yes, Mediacleanuparr supports per-title exclusion so a title can be excluded from future scans.
Will Mediacleanuparr delete files outside the configured media folder?
No, it never deletes outside your media folder.
Answers sourced from github.com
Community
- r/selfhosted on Reddit: Janitorr - Clean up your media library with ... (reddit)
- How do you guys handle media backups? : r/selfhosted - Reddit (reddit)
- Media Centers and automatic downloaders for PC : r/selfhosted - Reddit (reddit)
- Automated *ARR media stack for complete (and total) noobs - Reddit (reddit)
- Best media server : r/selfhosted - Reddit (reddit)
Collected 43 days ago - public community threads