Release history
Deleterr releases
Automated media cleanup tool that removes watched and stale content from Plex, Sonarr, and Radarr based on configurable rules. `MIT` `Docker`
All releases
31 shown
v0.2.17
Bug fix
Fixed transient connection errors during startup by adding retries.
Full changelog
v0.2.16
Bug fix
Fixed preservation of collection items across library entries in leaving-soon mode.
Full changelog
v0.2.15
Bug fix
Fixed bug where leaving-soon entries had incorrect stable removal dates for duplicate library names.
Full changelog
v0.2.14
New feature
Notable features
- Plex added as a watch data provider alternative to Tautulli
Full changelog
v0.2.13
New feature
Notable features
- Added duration property to leaving-soon for explicit deletion dates
Full changelog
v0.2.12
Bug fix
Fixed Tautulli TV show watch data matching to use the rating key.
Full changelog
v0.2.11
New feature
Notable features
- Add protection for overseerr content when requested by a user who has not watched it
Full changelog
v0.2.10
Breaking risk
Breaking changes
- API/CLI flag "Overseerr" renamed to "Seerr" (backward compatible)
Full changelog
v0.2.9
New feature
Notable features
- Added Mdblist list exclusion support
Full changelog
v0.2.8
Bug fix
Fixed graceful handling of death‑row movie deletion errors.
Full changelog
0.2.8 (2026-02-20)
Bug Fixes
v0.2.7
Bug fix
Fixed media_cleaner to correctly handle None titles during Plex item lookups.
Full changelog
v0.2.6
Maintenance
Minor fixes and improvements.
Full changelog
v0.2.5
Maintenance
Minor fixes and improvements.
Full changelog
v0.2.4
Bug fix
Fixed logging for the leaving_soon feature when the disk threshold is not met.
Full changelog
v0.2.3
Maintenance
Minor fixes and improvements.
Full changelog
v0.2.2
Bug fix
Prevent duplicate items in leaving_soon and deletion preview.
Full changelog
v0.2.1
New feature
Notable features
- Added last_watched sort field supporting multi‑level sorting
Full changelog
v0.2.0
Breaking risk
Breaking changes
- Built-in scheduler now enabled by default; Deleterr runs as a long‑lived daemon instead of exiting after one execution.
Notable features
- Added `leaving_soon` collection and labels for scheduled deletions
- Notification system supporting Slack, Discord, Telegram, and webhooks
- Preview_next option to show upcoming deletions
Full changelog
0.2.0 (2026-02-01)
⚠ BREAKING CHANGES
- The built-in scheduler is now enabled by default. Deleterr will run as a long-lived daemon process instead of running once and exiting.
Features
- add leaving_soon collection and labels for scheduled deletions (#200) (ea23877)
- add notification system for Slack, Discord, Telegram, and webhooks (#198) (e0f44b1)
- add preview_next option to show upcoming deletions (#197) (85a0824)
- enable scheduler by default (#188) (c39ac38)
Bug Fixes
v0.1.5
Bug fix
Fixed hangs caused by configuration errors to stop restart loops.
Full changelog
v0.1.3
Bug fix
Fixed release‑please triggering by using a PAT.
Full changelog
v0.1.2
Bug fix
Fixed missing `del_movie` method and added `__getattr__` safeguard.
Full changelog
v0.1.1
Bug fix
Notable features
- Sonarr-specific exclusions added
Full changelog
v0.1.0
Breaking risk
Breaking changes
- Removed interactive mode
Notable features
- Allow loading environment variables in YAML configuration
- Migrated to trunk-based development workflow
Full changelog
What's Changed
- Remove interactive mode by @rfsbraz in https://github.com/rfsbraz/deleterr/pull/168
- feat(config): Allow loading env in yaml by @albinmedoc in https://github.com/rfsbraz/deleterr/pull/170
- chore: Migrate to trunk-based development by @rfsbraz in https://github.com/rfsbraz/deleterr/pull/169
- docs: Add environment variables documentation by @rfsbraz in https://github.com/rfsbraz/deleterr/pull/171
- ci: Add release-please for automated releases by @rfsbraz in https://github.com/rfsbraz/deleterr/pull/172
- chore(main): release 0.1.0 by @github-actions[bot] in https://github.com/rfsbraz/deleterr/pull/173
New Contributors
- @albinmedoc made their first contribution in https://github.com/rfsbraz/deleterr/pull/170
- @github-actions[bot] made their first contribution in https://github.com/rfsbraz/deleterr/pull/173
Full Changelog: https://github.com/rfsbraz/deleterr/compare/v0.0.22...v0.1.0
v0.0.22
New feature
⚠ Upgrade required
- Docker images now require Python 3.12; update Docker build configurations accordingly.
- SSL verification is now configurable via the `ssl_verify` option.
Notable features
- JustWatch Integration for excluding media based on streaming availability with country and language settings
- Overseerr Integration to protect requested content and clean up old requests using status filters
- Built-in Scheduler offering preset (hourly, daily, weekly, monthly) and custom cron expressions plus timezone configuration
Full changelog
What's Changed
✨ New Features
-
JustWatch Integration - Exclude media based on streaming availability
- Keep media available on specific streaming services
- Keep media NOT available on streaming (rare/hard to find content)
- Configurable country and language settings
-
Overseerr Integration - Request-based media exclusions (#161)
- Protect requested content from deletion
- Clean up old user requests with configurable filters
- Support for request status filtering (pending, approved, declined)
-
Built-in Scheduler - Alternative to Ofelia/cron (#162)
- Preset schedules: hourly, daily, weekly, monthly
- Custom cron expressions supported
- Configurable timezone and run-on-startup option
-
Radarr Tags Support - Filter by Radarr tags, quality profiles, paths, and monitored status
🐛 Bug Fixes
- Docker Python 3.12 - Fixed broken Docker images by upgrading from Python 3.9 to 3.12 (#164)
- Make SSL verification configurable (
ssl_verifyoption) - Fix tag matching to be case-insensitive
- Various test and CI improvements
🔧 Maintenance
- Add Docker smoke test to CI to catch Python compatibility issues (#166)
- Handle fork PRs gracefully in CI workflows
- Add GitHub Pages documentation with auto-generated config reference
- Bump dependencies: tautulli, requests, PyYAML, pytest-mock
📚 Documentation
- Add CHANGELOG.md, CONTRIBUTING.md, SECURITY.md
- Add Portainer deployment instructions
- Auto-generated configuration reference from Pydantic schema
Full Changelog: https://github.com/rfsbraz/deleterr/compare/v0.0.19...v0.0.22