PosterFlow

PosterFlow is a self-hosted poster management system that syncs and manages movie and TV show posters across Google Drive using rclone.

  • Cloud
  • Media Applications
  • Media Servers
  • Tools & Utilities
PosterFlow is a self-hosted poster management system that syncs and manages movie and TV show posters across Google Drive using rclone. Features include drive syncing from community preset sources (MM2K, CL2K, etc.), automatic poster renaming to match your Plex/Radarr/Sonarr library, border replacement, unmatched asset detection, direct Plex upload, a built-in scheduler, and real-time job progress via WebSockets. Includes a setup wizard on first launch to configure your media server and Google Drive credentials.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

68/100 Good

Maintained
100last commit 18 days ago
Popular
2722 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
88no serious findings, 2 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 34 days ago

GitHub stars
22
Open issues
0
Last commit
2026-11-03
License
MIT
Activity
declining

Checked 10 days ago - source: GitHub (dweagle/posterflow)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fix the service file before starting Before starting, replace 'your_user' with your real username and set the app folder, data folder, and CONFIG_DIR to where you actually put them, because wrong paths or ownership can stop PosterFlow from running or hide its settings. You can also uncomment PORT if 8500 is already used, and set TZ or ALLOWED_FRAME_ORIGINS only if you need a different clock or extra allowed web addresses. source
  • Install Node.js first Run sudo apt install -y nodejs so the app has the JavaScript runtime it expects. Skipping it can make parts of PosterFlow fail or behave oddly. source
  • Start it and make it survive restarts Run sudo systemctl enable --now posterflow so PosterFlow starts now and automatically after your server reboots. If you later change the service file, run sudo systemctl daemon-reload and then sudo systemctl restart posterflow so Linux reads the updated settings. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which port should I expose for PosterFlow in Docker?

Use host port 8357 to access the main application. The provided compose example maps host port 8357 to container port 8000.

What volume do I need to mount, and what should I back up?

Mount ./config:/config as the only required volume. It stores posterflow.db, rclone.conf, drives_cache.json, the default poster cache, logs, scripts, and IDarr data, so back this directory up.

What do I configure on first launch?

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

Is there an Unraid template for PosterFlow?

Yes, PosterFlow is available in Community Apps for Unraid OS and can be installed from your server.

Where can I find help diagnosing failures?

The troubleshooting docs provide a symptom-to-cause-to-fix table, log substrings to grep in posterflow.log, log locations, and instructions for capturing a diagnostic bundle.

Answers sourced from ca.unraid.net, github.com, github.com

Community

Collected 49 days ago - public community threads