# Mediacleanuparr

Mediacleanuparr is a self-hosted media applications app. Prune your Radarr and Sonarr libraries by TMDb audience rating, with a mandatory dry run. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2430/mediacleanuparr

## Description

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.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 60 (last commit 153 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/tophat17/mediacleanuparr
- GitHub: https://github.com/tophat17/Mediacleanuparr
- Unraid: https://ca.unraid.net/apps/mediacleanuparr-02olhh70rhazef?q=mediacleanuparr

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2430/mediacleanuparr), the self-hosted and open-source app directory.
