PlexMind 1.0.0

PlexMind 1.0: sign in with Plex, a three-question install, and Model Trial to try any model on your GPU before switching. Since 0.9.15:

• A short README; reference material moved to docs/ (models, configuration, architecture, API and command line, upgrading). SECURITY.md describes Sign in with Plex and the generated keys.
• Sign in with Plex always shows an "Open Plex sign-in" link, so a blocked pop-up no longer leaves you with nothing to click.
• The Unraid template uses the :latest image, so Unraid offers updates after each release. Existing installs: set Repository to ghcr.io/finechainesium/plexmind:latest once.

v0.9.15

• Simpler install, on the way to 1.0:
  • Sign in with Plex: the dashboard and setup.sh use Plex's own sign-in link, so there is no token to find and paste. On first run it connects PlexMind to the server the account owns (asking which, if there are several); after that it is the dashboard login, for the server owner only. An API key still works for scripts.
  • The API key and webhook secret are generated on first start and kept in data/secrets.json; setting them yourself still works and wins.
  • setup.sh finds your Movies and TV folders from your Plex libraries (translating paths when Plex runs in Docker), picks a model for your GPU and downloads it with a checksum check, and writes a .env of about ten lines instead of a hundred. setup.sh --model DIR only fetches the model, for Unraid.
  • .env.example has the 7 settings people change; the full list moved to docs/CONFIGURATION.md. The Unraid template drops the Plex token, URL, keys and other settings that have defaults.
  • The Docker broker's allowed containers now follow WHISPER_CONTAINER_NAME and LLAMA_CPP_CONTAINER_NAME.
• Model Trial: the Model Advisor card can try any model in the models folder on this GPU before you switch. It runs the subtitle batches translation really sends (same prompts and checks) in up to two of your languages, plus a recommendation request, next to the model in use, and shows GPU memory, speed, unusable batches, rejected lines, word-for-word idioms, Simplified characters in Traditional Chinese, and invented or malformed picks. Translation pauses during a trial and resumes after. A model that fails (too much memory, too slow, or broken replies) cannot be selected.

v0.9.14

• Recommendations no longer stay stuck when someone ignores them. A set nobody watched from was kept forever, so 23 of 25 users were skipped in a recent run, some with picks from April; now a set older than REC_REFRESH_DAYS (25) is replaced either way.

• Dashboard fixes from an audit of every control:

  • Per-user Generate now also sends the recommendations to Plex, and says so.
  • Start uses the max runtime shown under Schedule (0 runs until done) instead of a hidden 60-minute limit.
  • Starting a job that is already running attaches to it instead of showing an error, and the scheduler no longer logs that as a failed launch.
  • Dates labelled UTC are shown in UTC.
  • The Plex card checks Plex itself; the header says Offline rather than Demo Mode; a Plex error no longer marks the API offline.
  • Maintenance cards say quarantine instead of delete, and the latest audit report is shown on the Maintenance page.
  • Settings: the API key is marked required, Test Connection checks the key, and saving handles errors.
  • Clearer wording for schedules, target languages, Whisper standby, the GPU card, Generate All waits and the Model Advisor (GiB, Refresh with a time, fixed list explained); shared Plex users are labelled Shared.

v0.9.13

• New logo: a P with a brain inside.
• Choose the model from the dashboard's Model Advisor card. It lists every GGUF in LLAMA_CPP_MODELS_DIR, remembers the last one used, and applies to recommendations at once and to translation at its next file. Compose now runs llama.cpp in router mode; LLAMA_CPP_MODELS_DIR replaces LLAMA_CPP_MODEL_PATH, and a model's name is its file name without .gguf.
• Default model is now Gemma 4 12B (gemma-4-12b-it-Q5_K_M), for translation and recommendations. PlexMind stays model-agnostic: any GGUF llama.cpp can load works. Installs relying on the Compose default must download the new file (see the README) or set LLAMA_CPP_MODEL_ALIAS to keep Qwen 3.5 9B.

v0.9.12

• Only call a recommendation a hidden gem if it really is little known: few TMDB votes for its type, low current popularity, not part of a film series, not a long-running show, and not trending.

v0.9.11

• Translate what people are watching first: the next episodes after each active viewer, then shows being watched, recently added titles, anything watched before, and the rest. Videos using an embedded or Plex subtitle share the same queue.
• Give the translation model the title, genres, synopsis and character names from Plex, plus the last few finished lines, and end batches at sentence breaks.
• Tell the model to translate slang and innuendo by meaning and to keep each line's words in its own line. A batch containing junk or a line far too long or short for its English is redone one line at a time.

v0.9.10

• Recommendations now score each candidate against the individual watched titles it most resembles, instead of one averaged taste profile. Candidates also come from TMDB's similar and recommended lists, watched titles count by how much of them was watched, rewatches, star ratings and thumbs up or down, the top picks keep some variety, and each reason names the titles a pick actually matched.

v0.9.9

• Add a Throttle page to the dashboard: switch each sensor on or off, set its limit and see its current reading. Saved limits replace the THROTTLE_* settings and reach running jobs, including one already held.

v0.9.8

• Translate videos that have no English .srt file from an English text subtitle inside the video or held by Plex. The source stays in PlexMind's data folder, so Plex does not list a second English subtitle. Picture subtitles (PGS, VobSub) cannot be used.

v0.9.7

• Hold transcription, translation, maintenance and recommendation jobs while the server is too hot or short of memory, with a separate limit for each of GPU, CPU, NVMe, hard drive temperature and RAM (THROTTLE_*; blank turns a sensor off, and all are off by default). Jobs resume once every enabled sensor has cooled by THROTTLE_RESUME_MARGIN.