/Eraserr

Python script for deleting unwatched or stale media from Plex servers using Tautulli, Radarr, Sonarr, and Overseerr.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Eraserr

image

Eraserr is a Python script designed to help keep your Plex servers clean. It deletes unwatched or stale media by leveraging the functionality of Tautulli, Radarr, Sonarr, and Overseerr.

Table of Contents

Installation

Prerequisites

  1. First, clone the script to your machine and navigate to the resulting directory:
git clone https://github.com/everettsouthwick/Eraserr.git
cd Eraserr
  1. Then, install the required packages to run the script:
pip install -r requirements.txt

Usage

To use the script, run the following command:

python eraserr.py

Docker

Pulling the image

You can pull the latest container image from the Docker repository by running the following command:

docker pull ecsouthwick/eraserr

To pull the develop branch from the Docker repository, add the :develop tag to the above command:

docker pull ecsouthwick/eraserr:develop

Running the Container

Once you have pulled the image from docker, you may use the following command to run the container:

docker run -d --name eraserr --volume /path/to/config.json:/app/config.json ecsouthwick/eraserr

Note: The recommended restart policy for the container is on-failure or no.

Configuration

  1. Copy config.example.json to config.json.
  2. See CONFIGURATION.md for detailed instructions on setting up config.json.