Mediacleanuparr

Prune your Radarr and Sonarr libraries by TMDb audience rating, with a mandatory dry run.

  • Media Applications
  • Tools & Utilities
Prune your Radarr and Sonarr libraries by TMDb audience rating, with a mandatory dry run. Scans movies and TV, flags titles below a user-rating threshold you choose, shows a dry-run estimate of the space that would be freed, and only deletes after you review the list and type DELETE. Extra tools: a "Biggest items" view to clear large titles you never watch, an "Empty / 0-byte cleanup" toggle (removes empty entries that are also below your threshold, plus orphaned empty folders), per-title "exclude from future scans", and optional Overseerr/Jellyseerr sync so deletions stop being auto-requeued. Defaults to DRY-RUN-ONLY and never deletes outside your media folder. Everything else — Radarr, Sonarr, TMDb (required), and optional Seerr URLs/keys, the threshold, and the safety switches — is configured in the web UI after the container starts and saved to /config.

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

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

Collected 43 days ago - public community threads