# Media Purge

Media Purge is a self-hosted media applications app. Rule-based media cleanup for Plex and Jellyfin. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3031/media-purge

## Description

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.

## Health score

54/100 (Fair), based on 4 of 4 factors.
- Maintained: 79 (last commit 74 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 85 (512 MB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/media-purge-0chx7ny00h3jg2?q=media-purge

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

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