sdblepas/cineplete repository overview

Self-hosted Plex movie library auditor that analyzes your collection using TMDB and highlights missing franchise movies, director gaps, and classic films.

⁠Cineplete

Cineplete is a self-hosted tool that audits a Plex movie library and analyzes it against TMDB to identify gaps in your collection.

It helps answer questions like:

• Which movies am I missing from a franchise?
• Do I have most movies from my favorite directors?
• Which highly rated classics are missing from my library?
• Which Plex movies have broken or missing metadata?

The tool generates a web dashboard with insights about your movie collection.

⁠Features

• Franchise completion tracking
• Director filmography gap detection
• Actor filmography analysis
• Classic movie recommendations
• TMDB suggestions
• Detection of Plex items without TMDB metadata
• Wishlist management
• Optional Radarr integration to add movies directly

⁠Tech Stack

• Python + FastAPI
• Plex metadata parsing
• TMDB API
• Docker container
• GitHub Actions CI/CD

⁠Quick Start

docker run -d \
  -p 8787:8787 \
  -v ./config:/config \
  -v ./data:/data \
  sdblepas/cineplete:latest


version: "3.9"
services:
  cineplete:
    image: sdblepas/cineplete:latest
    container_name: cineplete
    ports:
      - "8787:8787"
    volumes:
      - /volume1/Docker/cineplete/config:/config
      - /volume1/Docker/cineplete/data:/data
    labels:
      net.unraid.docker.webui: "http://[IP]:[PORT:8787]"
      net.unraid.docker.icon: "https://raw.githubusercontent.com/sdblepas/CinePlete/main/assets/icon.png"
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8787')"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 20s
    restart: unless-stopped