# deleterr

> Deleterr is a self-hosted, open-source tool that automatically cleans up Plex libraries by deleting unwatched or old content with smart exclusions and a grace period.

- **Category:** Media Management
- **Licence:** MIT
- **Latest version:** v0.3.0
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker, Docker Compose, Portainer
- **Tags:** Automation, Radarr, Sonarr, Media Server, Library Management, Overseerr, Tautulli, Plex, Watch History, Docker, Python, Self Hosted, Media cleanup, Plex media server, Tautulli Api, Plex Server, Sonarr3, Radarr Api, Sonarr Api, Streaming Availability

## Description

Deleterr is a self-hosted Python application that automates Plex media library cleanup. It connects to Plex, Tautulli, Radarr, and Sonarr to analyze watch history and metadata, then removes media files matching user-defined criteria such as watch status, age, and streaming availability. Key capabilities include smart exclusions by genre, actor, collection, Trakt or MDBList lists, and JustWatch streaming availability; watch-based rules; multi-instance support for separate 4K libraries; a dry-run mode for safe testing; and a signature Leaving Soon feature that tags content for a grace period before deletion while notifying users through multiple channels. It runs as a Docker container with a built-in scheduler or can be triggered externally via Ofelia. Configuration is done through a single YAML file. The project is MIT-licensed and actively maintained.

## Links

- [Homepage](https://github.com/rfsbraz/deleterr)
- [Website](https://rfsbraz.github.io/deleterr/)
- [Docker](ghcr.io/rfsbraz/deleterr)
- [Getting Started Guide](https://rfsbraz.github.io/deleterr/getting-started/)
- [Configuration Reference](https://rfsbraz.github.io/deleterr/CONFIGURATION/)
- [Templates](https://rfsbraz.github.io/deleterr/templates/)
- [Docker Hub](https://hub.docker.com/r/rfsbraz/deleterr)
- [GitHub Repository](https://github.com/rfsbraz/deleterr)

---
Source: https://selfhost.directory/project/deleterr