2.1.1

What's new in v2.1.1

Scheduled jobs now show poster previews in Reset Posters

Posters applied by a scheduled job were landing in the Reset Posters list with a blank placeholder instead of a thumbnail. Scheduled runs now record the poster preview (and the exact applied image URLs) just like a manual apply, so those items show their artwork and light up the "in library" markers. Items applied by earlier scheduled runs stay blank until the job runs again.

Reset All keeps its progress when you leave the page

Starting a Reset All and navigating away no longer loses track of what's resetting. The reset now runs above the page, so leaving and coming back shows the live "Resetting… N/M" progress and each item's status, matching what the log already reported. Single resets survive navigation too.

2.1.0

What's new in v2.1.0

Reset Posters: free up space on your Plex server

The Reset Posters page can now delete the custom poster and background images this tool uploaded, not just switch the artwork back. Turn on Delete uploaded images and a reset also removes those uploaded files from your Plex server, then hit the new Clean Bundles button to reclaim the disk space right away instead of waiting on Plex's weekly maintenance.

• Clean Bundles tracks the real task and finishes exactly when Plex does, with no fixed wait.
• It stays available even after you've cleared every tracked poster.

Reset Posters redesign

• Items now drop off the list on their own once reset, so there's no more hitting Refresh to see what's left.
• Source-colored rows (MediUX / ThePosterDB), larger poster thumbnails, and loading skeletons.
• With delete armed, the page and each row's button clearly warn before anything is removed.

Sharper collection-set matching (MediUX)

Backdrops and title cards inside a MediUX collection set now route to the exact movie they belong to and match your library by TMDB id, recovering that id from the set's poster for the same movie. Fewer collection backdrops landing on the wrong item or going missing.

Redesigned Browser Engine settings

The Chromium engine card got a fresh look: a little browser-window emblem with a live status light, the detected Chromium build number, and one-click copy for the executable path.

Clearer Title Mappings guidance

When a TMDB API key is set, the Title Mappings page now confirms in green that the section is usually unnecessary (your library matches by id) while still letting you add a mapping as a fallback for the rare title that won't match on its own.

Polish

• Reordered the dock so Manual Import sits before Title Mappings.
• Small layout fixes on the Library and Scheduler pages.

2.0.24

What's new in v2.0.24

Smarter matching for manual scrapes and bulk lists

Pasted MediUX links and saved bulk lists now match your library by TMDB id - the same exact matching the Library Browser uses - instead of guessing by title and year. That means fewer "not in library" misses and wrong-title applies, especially for TVDB/IMDb-agent libraries (such as anime via HAMA).

Collection sets apply to the whole collection by default

Applying a MediUX collection set now spreads across every movie in the collection that's in your library, plus the collection poster, right out of the box. The per-set toggle still lets you narrow it back to just the title you're viewing.

Redesigned manual import

• A cleaner tabbed header (Scrape URLs / Bulk Files) with a sliding indicator.
• A themed paste box - the stray white resize grip and chunky native scrollbar are gone.
• Quick Browse buttons open ThePosterDB and MediUX in your browser, right where you paste links.

In-app Docker update guide

Docker and unraid builds can't self-update, and the container has no desktop to open a link on. The update notice now opens an in-app guide with copy-ready pull, rebuild, restart commands for unraid, Windows, Mac/Linux, and Compose.

Now on unraid Community Applications

Install it straight from the unraid Apps tab - search Plex Poster Helper. It pulls the prebuilt Docker Hub image and gives you a WebUI button, no commands needed.

2.0.23

What's new in v2.0.23

Redesigned navigation: bottom dock

The left sidebar is gone, replaced by a floating dock at the bottom of the window. Navigation stays out of the way, pages get the full width, and the whole layout feels cleaner and more focused.

Instant search (Ctrl/Cmd+F)

A new command palette puts everything a keystroke away. Press Ctrl+F (Cmd+F on macOS) from anywhere to:

• Jump straight to any page or Settings section
• Find a movie or show across all your libraries and open its MediUX sets
• Open a MediUX creator
  No more hunting through menus.

Smarter TMDB ID matching (optional API key)

Library matching now prefers exact TMDB IDs instead of guessing by title and year. Add a free TMDB v3 API key in Settings and the tool will:

• Match titles by ID, fixing most matching and title-mapping issues automatically
• Resolve TVDB/IMDb-agent libraries (such as anime via HAMA) to the correct TMDB entries

The key is optional. Without it, matching falls back to title and year as before.

v2.0.22

Fixes

• Settings → Reinstall browser no longer reports the install as finished a few seconds in while the download is still running. The completion fallback introduced in 2.0.20 resolved as soon as it found any Chromium binary on disk - during a reinstall the old binary is still there, so it fired immediately. It now only fires when a new binary appears (first install or version upgrade); same-version reinstalls wait for the installer to actually finish. Affected all platforms and deployment methods.

Docs

• First-run setup notes in both READMEs: the app downloads a one-time ~115 MB Chromium on first launch, and if the setup screen ever sticks after the download completes, restarting the app (or docker restart plex-poster-helper) picks the browser up immediately.

v2.0.21

Docker

• Clipboard permission now prompts automatically. The KasmVNC web client never asks the browser for clipboard permission on its own, so seamless copy & paste stayed dead unless you dug into per-site browser settings. The container now nudges the native permission prompt on your first click inside the app (Chrome / Edge / Brave) - click Allow once and clipboard syncs both ways from then on.

Docs

• HTTPS clipboard access documented across the main README and the Docker guide.
• Per-browser clipboard notes: Vivaldi suppresses the prompt (one-time manual allow via the padlock icon), Firefox/Safari don't support seamless clipboard (use the KasmVNC side-panel clipboard).
• Custom port overrides documented: -Port / -HttpsPort (PowerShell), PORT / HTTPS_PORT (bash), and the compose/unraid mappings.

v2.0.20

Docker

• HTTPS access on a second port (default 3940, self-signed, zero setup). Browsers only allow clipboard access on secure pages, so this enables copy & paste between your machine and the containerized app - the plain http port can't offer it.
• KasmVNC stream quality now defaults to the best possible: lossless encoding, full color, 60 fps, native desktop resolution with dynamic resize.
• The unraid template WebUI button opens the https port so clipboard works out of the box.
• Compose, the run scripts (-HttpsPort / HTTPS_PORT), and the unraid template all expose the new port.

Fixes

• First-run Chromium download could hang at 100% in containers, requiring an app restart to finish setup. The installer now detects the completed download on disk and continues automatically.

Docs

• Docker guide covers the https clipboard flow, the self-signed certificate warning, and the "400 Bad Request - plain HTTP request sent to HTTPS port" pitfall (type the https:// prefix explicitly).

v2.0.19 - Docker guide clarity & timezone fixes

Documentation and launcher polish - no app behavior changes.

Docker guide

• Reframed around the single GUI container. It is the full app in your browser and runs your schedules 24/7 on its own, so it is all most people need.
• The headless scheduler is now clearly optional and skippable - a lighter, window-less runner for people who would rather not keep the desktop alive, not a required second half.
• New Step 2 callout: the GUI is a web app you open from any device on your network, so a server, NAS, or unraid box never needs a screen or desktop of its own.

Launcher scripts

• run.ps1 and run.sh now honor an explicit TZ override.
• run.sh reads the macOS /etc/localtime symlink instead of silently falling back to UTC, so automatic host timezone detection works on macOS as the guide promises.

v2.0.18 - Scheduler engine coordination

Scheduler: GUI and headless now coordinate

If you run the desktop/GUI app and the headless Docker scheduler against the same /config, they used to both fire cron jobs - so every scheduled job ran twice. This release fixes that with a clean editor/engine split.

What changed

• No more double runs. When the headless scheduler is up it claims the "engine" role via a small heartbeat file in the shared config. Any GUI sharing that config defers all automatic runs to the engine.
• GUI is your editor and dashboard. Schedule changes you make in the GUI are picked up by the engine within ~30s, with no restart - jobs re-read their config at fire time.
• Run now is always local. Manual runs from the GUI run on demand regardless of the engine.
• Status banner. The Scheduler tab shows a banner when a 24/7 engine is handling the jobs, so you always know what is firing them.
• Desktop installs are unchanged. The heartbeat file is never created on a standalone desktop install, so single-app behaviour is exactly as before.

Notes

• Docker README updated to explain the editor/engine model and the "they won't trip over each other" guarantee.

Full changelog: v2.0.17...v2.0.18

2.0.17

What's new in v2.0.17

Docker

• One launcher, three modes. ./docker/run.sh (or run.ps1 on Windows) now takes a target: gui (default), headless, or both — with target-aware --build and --stop. Adding the 24/7 scheduler next to the GUI is now a single command.
• Shared config that actually shares. The GUI and the headless scheduler mount the same ppsh-config volume, so the scheduler picks up your Plex sign-in and schedules from the GUI automatically — no tokens to copy, no env vars to set. This also fixes a path mismatch where the two images stored data in different places, so sharing a volume never truly lined up before; old headless layouts are migrated automatically on first start.
• Schedules now fire at your local time on Windows. run.ps1 converts your Windows timezone to the IANA name containers expect — previously schedules silently ran in UTC. The shell launcher detects your host timezone too.
• Compose cleanup. docker-compose.yml documents all three modes (gui, headless, both via --profile headless), and PLEX_BASEURL / PLEX_TOKEN are now commented-out optional overrides instead of placeholder values that could clobber your saved sign-in.

Docs

• The Docker guide's headless section is now a one-command walkthrough, with Compose and plain docker run alternatives.
• The Updating instructions were rewritten with copy-paste blocks for every platform and deploy method (Windows, Mac/Linux, Compose, unraid) — and now correctly rebuild the image, which the old instructions skipped.
• The main README gained an Updating section covering the desktop app, source installs, and Docker.

---

Install: Windows Plex-Poster-Set-Helper-Setup-2.0.17-Windows.exe · Linux .AppImage / .deb. Existing installs update automatically.