# jellysweep

> Self-hosted cleanup tool for Jellyfin that removes old, unwatched media by analyzing stats and user requests, with disk-usage adaptive deletion.

- **Category:** Media Management
- **Licence:** GPL-3.0
- **Latest version:** v0.16.1
- **Open source:** oss
- **Languages:** Go, templ
- **Platforms:** Docker Compose
- **Tags:** Automation, Radarr, Sonarr, Pwa, Media Management, Jellyfin, Docker, Cleanup, Self Hosted, Jellyseerr, Cleanup Tool

## Description

Jellysweep is a self-hosted media cleanup tool for Jellyfin servers. It connects to Jellyfin, Sonarr, Radarr, Jellyseerr, and optionally Jellystat or Streamystats to analyze viewing statistics and user requests. Based on configurable filters (content age, last stream date, size, favorites, Tunarr usage, and exclusion tags), it marks eligible media for deletion by tagging items in Sonarr/Radarr. Users can request to keep specific items through a web interface, and admins review these requests. After a configurable grace period — which shortens automatically when disk usage crosses defined thresholds — the tagged media is deleted. The tool offers three cleanup modes for TV series (all, keep_episodes, keep_seasons), creates Jellyfin "Leaving" collections for scheduled deletions, and provides a Progressive Web App interface with OIDC or Jellyfin authentication. It runs via Docker Compose, uses SQLite or PostgreSQL for its own database, and can cache with Valkey/Redis.

## Links

- [Homepage](https://github.com/jon4hz/jellysweep)
- [Docker](ghcr.io/jon4hz/jellysweep)
- [GitHub Repository](https://github.com/jon4hz/jellysweep)

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