Media Purge

Rule-based media cleanup for Plex and Jellyfin.

  • Media Applications
  • Tools & Utilities
Rule-based media cleanup for Plex and Jellyfin. Scans your libraries, recommends what to delete (never watched, watched years ago, duplicates, low quality, dead series...) with a transparent explanation for every suggestion, and reclaims space through a staged pipeline: approve -> recycle bin -> purge after retention. Ships dry-run enabled so nothing is deleted until you decide you trust it. Also includes ImageMaid-style server maintenance (Plex PhotoTranscoder cache purge, Clean Bundles / Optimize DB, Jellyfin cache tasks). Every action is written to a permanent activity log.

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.

54/100 Fair

Maintained
79last commit 74 days ago
Popular
102 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
85512 MB minimum RAM

Availability: platform listings confirmed today, links checked 20 days ago

GitHub stars
2
Open issues
1
Last commit
2026-09-08
Latest release
v0.3.1
License
MIT
Activity
stale

Checked 6 days ago - source: GitHub (ktordoff13/media-purge)

Resources & Compatibility

Minimum requirements: 512 MB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Installation Runs as an unRAID Community Applications container, but works on any Docker host. Dry-run is enabled by default, so nothing is deleted until you approve actions. source
  • First run Deploy the unRAID Community Applications container (or any Docker host). Media Purge starts in dry-run mode, so review and approve its recommendations before anything is deleted; every action is written to a permanent activity log. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does it delete media automatically on first run?

No. It ships with dry-run enabled, and deletion is staged: approve, then files move to a recycle bin, and purge only after a retention window, default 30 days.

Will it re-download files through Sonarr or Radarr after cleanup?

On approval, the matching *arr entry is unmonitored so it does not re-download what you just deleted. It can also downgrade instead of delete, asking Radarr or Sonarr to replace the file with a smaller release.

What Plex and Jellyfin maintenance tasks can it run?

It can purge Plex's PhotoTranscoder cache, trigger Clean Bundles, Optimize Database, and Empty Trash, and run Jellyfin cache, transcode, and database optimization tasks.

How is the app's own data stored?

It uses SQLite, and keeps everything in one file in /config.

Is the local AI advisor required?

No, the AI advisor is optional and only adds display-only notes. It has no effect on scoring or deletions, and the app is fully functional without it.

Answers sourced from github.com

Community

Collected 29 days ago - public community threads