Skip to content

Deleterr is a Python script designed to help you manage available disk space in your Plex media server.

License

Notifications You must be signed in to change notification settings

fastrack20/deleterr

This branch is 1 commit ahead of, 94 commits behind rfsbraz/deleterr:develop.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

9020814 · Mar 5, 2024
Mar 5, 2024
Aug 17, 2023
Mar 5, 2024
Feb 22, 2024
Feb 19, 2024
Feb 19, 2024
Feb 28, 2024
Feb 28, 2024
Mar 5, 2024
Aug 18, 2023
Aug 2, 2023
Nov 26, 2023
Feb 28, 2024
Aug 2, 2023
Nov 25, 2023
Feb 27, 2024
Aug 26, 2023
Nov 24, 2023
Feb 19, 2024
Feb 28, 2024

Repository files navigation

Deleterr GitHub version Coverage Status

Deleterr uses Radarr, Sonarr, and Tautulli to identify and delete media files based on user-specified criteria. Deleterr is customizable, allowing you to specify metadata based rules for different libraries and sonarr/radarr instances.

Setup Deleterr to run on a schedule and it will automatically delete media files that meet your criteria. This allows to keep your library fresh and clean, without having to manually manage it to free up space.

WARNING

  • DO NOT USE THIS WITH MEDIA CONTENT YOU CAN'T AFFORD TO LOSE
  • Turn on the recycle bin in your Sonarr/Radarr settings if you want to be able to recover deleted files (not recommended for remote mounts)

Docker Compose

Adding deleterr to your docker-compose file is really easy and can be combined with ofelia to run at a schedule. Here's an example that runs deleterr weekly:

version: "3.9"
services:
    deleterr:
        image: ghcr.io/rfsbraz/deleterr:latest
        container_name: deleterr
        environment:
            LOG_LEVEL: INFO
        volumes:
            - ./config:/config
            - ./logs:/config/logs
        restart: no
    scheduler:
        image: mcuadros/ofelia:latest
        container_name: scheduler
        depends_on:
            - deleterr
        command: daemon --docker
        volumes:
            - /var/run/docker.sock:/var/run/docker.sock:ro
        restart: unless-stopped
        labels:
            ofelia.job-run.deleterr.schedule: "@weekly"
            ofelia.job-run.deleterr.container: "deleterr"

You can find more information about ofelia's scheduling options here.

Docker

Set your settings file in config/settings.yaml and run the following command:

docker run -v ./config:/config -v ./logs:/config/logs ghcr.io/rfsbraz/deleterr:latest -e LOG_LEVEL=DEBUG

Configuration

Deleterr is configured via a YAML file. An example configuration file, settings.example.yaml, is provided. Copy this file to settings.yaml and adjust the settings as needed.

Please refer to the configuration guide for a full list of options and their descriptions.

Image Availability

The image is available through:

Tags

  • latest: The latest stable release
  • nightly: The latest development release
  • X.Y.Z: A specific version
  • X.Y: The latest release in the vX.Y series
  • X: The latest release in the vX series

About

Deleterr is a Python script designed to help you manage available disk space in your Plex media server.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.2%
  • Dockerfile 1.2%
  • Makefile 0.6%