Version 3.0.0 — Breaking Release
This is a major (v3) release with breaking changes. Please read below before upgrading.
⚠️ Breaking Changes
- PyPI: The package is no longer published on PyPI. Use the Docker image or install from source if you were using
pip install. - Recommended way to run: Docker + Web UI are now the recommended way to run Plex Generate Previews. The CLI still works (e.g. inside the container or from source), but we recommend the Docker image and Web UI for setup, scheduling, and job management.
What's New in v3
- Web UI: Full dashboard, setup wizard (including Plex OAuth), settings, job logs, scheduling (cron/interval), and Radarr/Sonarr webhooks.
- Fix: Jobs now correctly use the Plex Data Path (and Plex URL/token) saved in Settings. Previously, jobs could fail with "PLEX_CONFIG_FOLDER is required" even when the path was set in the UI; that's fixed. Thanks to @jonathan-vella for the PR.
- ETA display, WebSockets, CORS, and library filtering improvements; security hardening (rate limiting, CSRF, path traversal protection).
- Documentation reorganized (docs hub, getting started, reference, guides); Unraid template available.
Upgrade
- Docker: Pull the new image and recreate the container; see Getting Started. Existing
/config(and env vars) continue to work. - From source: Pull the repo and reinstall; use the Web UI on port 8080 or the CLI as before.
This release was shipped with limited testing due to time constraints, so you may hit rough edges. If you run into issues, please open an issue (or a PR). Feedback and bug reports are appreciated.