PosterFlow

A self-hosted poster management system that syncs and manages movie and TV show posters across Google Drive using rclone. Includes a FastAPI backend and React/TypeScript frontend, packaged as a single Docker container.

PosterFlow is heavily inspired by DAPS by Drazzilb

See the Wiki for more information Wiki

Dashboard

The dashboard is the top landing spot when accessing the app. The sidebar exposes every top-level surface.

Features

• Drive Syncing — Subscribe to community preset drives (MM2K, CL2K, etc.) or add your own custom Google Drive sources
• Poster Renamer — Automatically renames downloaded posters to match your Plex/Radarr/Sonarr library
• Border Replacer — Replaces poster borders in bulk
• Unmatched Assets — Detects and reports assets in your library that are missing posters. TMDB links for missing items
• Plex Upload — Upload posters directly to Plex libraries
• IDarr — Metadata enrichment pipeline for poster-maker assets (TMDB/TVDB/IMDB ID assignment and rename normalization)
• Community Requests — Shared request board where users submit missing posters for makers to claim and fulfill. Discord integration auto-fills your username and unlocks an upload button for verified poster makers
• Maker Tools — Poster-makers can monitor upcoming movie and TV releases to track missing posters
• Scheduler — Automate any job on a recurring schedule
• Live Job Status — WebSocket-powered real-time job progress and log streaming
• After Job Scripts — Autorun a custom script after a completed job
• Discord Notifications — Optional notifications on job completion

Quick Start

The setup wizard runs on first launch to configure your media server connections and Google Drive credentials.

Access

Install

Currently the only install route is Docker. An Uraid template is available in CA.

Docker Compose

Currently only a develop tag exists

docker-compose.yml

The canonical compose file. Every key is explained inline.

services:
  posterflow:
    image: dweagle/posterflow:develop
    container_name: posterflow
    ports:
      - "8357:8000"
    volumes:
      # The only required mount. Holds posterflow.db, rclone.conf, drives_cache.json,
      # the default poster cache (/config/posters/gdrive/), /config/logs/,
      # /config/scripts/ and /config/idarr/. Back this directory up.
      - ./config:/config

      # Optional. Mount your Kometa assets directory here (or anywhere) and point
      # the renamer's "Destination" setting at it. Without this mount, PosterFlow
      # writes its organized output under /config/posters/assets/ and you have
      # to copy it out yourself.
      - /path/to/kometa/assets:/assets

      # Optional, poster-makers only. Mount the directory where you stage posters
      # you intend to upload to your personal Google Drive via IDarr.
      - /path/to/idarr/staging:/idarr
      
    environment:
      - PUID=1000        # Host UID that owns the mount points above.
      - PGID=1000        # Host GID. Both default to 1000 if unset.
      - TZ=America/New_York   # Host timezone. Drives scheduler local-time interpretation.
      - DEBUG=false      # Optional. true forces file logging to DEBUG on startup.
      - LOG_LEVEL=INFO   # Optional. File log level when DEBUG=false.
      - CORS_ORIGINS=    # Optional. Comma-separated origins (see configuration.md).
    restart: unless-stopped

Equivalent docker run

docker run -d \
  --name posterflow \
  -p 8357:8000 \
  -v /srv/posterflow/config:/config \
  -v /srv/kometa/assets:/assets \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=America/New_York \
  --restart unless-stopped \
  dweagle/posterflow:develop

Volumes

Environment Variables

Debug mode state is persisted in the database and restored on restart. You can toggle it from Settings without restarting the container.