battermanz/staleflix repository overview

⁠StaleFlix

StaleFlix (GitHub⁠) is a self‑hosted web application that helps you locate and act on stale (unwatched or barely watched) items in your Plex library. It interrogates Plex and companion services (Overseerr, Radarr, Sonarr) to build a list, then lets you:

• Review the items in a sortable table
• Upload resized poster art to Cloudinary (for lighter emails)
• Generate an inlined HTML newsletter and dispatch it via Listmonk
• Tag the selected titles in dedicated Plex collections for subsequent clean‑up

⁠Required companion applications and services

The following external applications and services are required to run StaleFlix:

• Plex Media Server: for your media library and playback statistics
• Overseerr: to retrieve requester information
• Radarr: to fetch movie file sizes
• Sonarr: to fetch TV show file sizes
• Cloudinary: for hosting poster images
• Listmonk: for generating and dispatching newsletters

⁠How it works

⁠Configuration

Copy the sample file at the root of your project folder and populate your secrets:

cp .env.example .env

Key variables (see the template for the full list):

• PLEX_URL, PLEX_TOKEN – access to your Plex server
• OVERSEERR_API_URL, OVERSEERR_API_KEY – requester information
• RADARR_API_URL, RADARR_API_KEY & SONARR_API_URL, SONARR_API_KEY – on‑disk sizes
• CLOUDINARY_* – poster uploads
• LISTMONK_* – newsletter delivery
• STALE_MONTHS – age threshold (default 6)

(.env.example⁠)

⁠Running with Docker

An official image is available on Docker Hub and can be deployed with the provided Docker Compose file (docker-compose.yml⁠):

docker compose up -d

This command will pull the battermanz/staleflix:latest image (or any version you specify in docker-compose.yml) and launch the service on port 9999. To run a specific tag, adjust the image field in docker-compose.yml or override it:

docker compose pull
daocker compose up -d

Alternatively, you may run the container directly:

docker run -d --name staleflix \
  -e TZ=Etc/UTC \
  --env-file .env:ro \
  -p 9999:9999 \
  battermanz/staleflix:latest

⁠Licence

This project is distributed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See the LICENSE file for the full text.