Stars
Forks
Watchers
Developer links
Maintainerr
Automating media server storage reclamation, Maintainerr is an open-source library maintenance platform that identifies unwatched, abandoned, or stale movies and shows across Plex, Jellyfin, and Emby and clears them on a schedule. Storage drives fill up rapidly when household members request four-season series or high-bitrate films, watch a single episode, and abandon the rest indefinitely. Instead of forcing administrators to audit disks by hand, the rule engine evaluates metadata from your media server alongside Tautulli watch histories, Seerr and Ombi request records, and Radarr, Sonarr, or Sportarr profiles every eight hours. Matching items enter a staging collection that syncs back to your media server home screen as a Leaving Soon row, complete with dynamic poster overlays displaying the exact removal date so viewers have a grace period to finish watching. Before enabling any destructive workflow, you can run the Test Media inspector against any movie or episode to preview rule evaluations and protect favorites with global or per-collection exclusions. Once the countdown expires, the collection handler deletes or unmonitors files, updates import-list exclusions so automated lists never re-download removed titles, clears orphaned requests in Seerr and Ombi, removes leftover sidecar folders, and dispatches alerts through Discord, Slack, Telegram, Pushover, Gotify, Email, or webhooks. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Automated Storage Reclamation Without Manual Audits
- Replaces manual disk cleanup by evaluating watch history, request age, and disk metadata every eight hours, staging stale movies and episodes into collections and deleting them after a configurable grace period.
- Leaving Soon Collections and Poster Overlays
- Syncs matched titles to Plex, Jellyfin, or Emby home screens and renders customizable countdown badges directly onto movie and series posters so users know when content will leave.
- Full Arr and Request Stack Synchronization
- Coordinates deletions across Radarr, Sonarr, Sportarr, Seerr, and Ombi simultaneously, unmonitoring titles, adding import-list exclusions to prevent re-downloads, and resetting request statuses cleanly.
- Safe Rule Testing and Granular Exclusions
- Provides an interactive Test Media dry-run inspector, active playback deferral that never deletes mid-stream media, and global or collection-scoped exclusions to protect essential library titles.
Features
- Multi-Source Rule Engine
- Evaluates complex boolean rules combining Plex, Jellyfin, Emby, Tautulli, Radarr, Sonarr, Sportarr, Seerr, and Ombi attributes across movies, shows, seasons, and individual episodes.
- Dynamic Poster Overlay Renderer
- Applies customizable countdown text, date badges, fonts, and color themes onto library posters and reverts the original artwork automatically if an item leaves the collection.
- Radarr and Sonarr Actions
- Supports deleting files, unmonitoring releases, switching quality profiles, applying rule-group tags, adding import-list exclusions, and cleaning up leftover folders with subtitle and NFO sidecars.
- Seerr and Ombi Reset
- Clears or resets associated user requests in Overseerr, Jellyseerr, Seerr, and Ombi when media is removed so users can re-request titles cleanly in the future.
- Multi-Channel Event Notifications
- Sends automated notifications for rule matches, upcoming expirations, and completed deletions via Discord, Slack, Telegram, Pushover, Gotify, LunaSea, SMTP email, and custom webhooks.