SubtitleGenie 0.0.4

SubtitleGenie 🧞 0.0.4

📝 What changed in 0.0.4

Added

• ffmpeg help & opt-in install. When embedding is requested but ffmpeg isn't
  found, SubtitleGenie now prints the official download link
  (https://ffmpeg.org/download.html), per-OS PATH instructions, and package-
  manager one-liners — and offers to fetch it for you. subtitlegenie install-ffmpeg downloads an official/trusted static build (gyan.dev on
  Windows, John Van Sickle on Linux) into <config dir>/bin and uses it
  automatically; ffmpeg on PATH still takes priority. macOS is guided to
  brew install ffmpeg. We don't bundle ffmpeg in releases (GPL + codec-patent
  reasons); the on-demand download keeps that clean.

• Self-update that installs itself. On a normal run (or via
  subtitlegenie update) SubtitleGenie checks GitHub for a newer release
  (interactive, throttled to once a day). If you accept, it downloads the archive
  for your OS, unzips the new executable next to your current one (version-
  stamped names never collide), and hands off to it — on Windows it opens the new
  version in a fresh console, on macOS/Linux it replaces the running process in
  the same terminal — carrying along the same movie you dropped, so the update is
  a single click and the job continues on the new version. Suppress a single run
  with --no-update-check; turn the automatic check off with
  config --set updates.check_on_run false.

• Release archives now contain a clearly named binary,
  SubtitleGenie_<os>_v<version> (win/mac/linux, e.g.
  SubtitleGenie_win_v0.2.0.exe), and the build stamps that version into the
  binary so --version and the update check report the release it was built
  from.

• Real 3D subtitles. In 3D mode SubtitleGenie now rewrites the downloaded
  subtitle into a per-eye .ass file: for Side-by-Side it draws one copy in the
  left half and one in the right (each horizontally squeezed for Half-SBS), and
  for Over-Under it stacks top/bottom copies (vertically squeezed for Half-OU).
  Previously the 3D option only affected naming/matching, so a flat subtitle was
  rendered once across the seam and didn't fuse on a 3D display.

  • New flags: --3d-format {auto,hsbs,sbs,hou,ou}, --3d-depth N
    (per-eye shift; 0 = screen plane), --keep-flat (also keep the plain 2D
    subtitle). New config keys: defaults.three_d_format,
    defaults.three_d_disparity, defaults.three_d_keep_flat.
  • Frame resolution is probed with ffprobe so the per-eye positions match the
    actual movie; falls back to 1080p when ffprobe isn't available.
  • Embedding 3D subtitles into MKV keeps them as ASS (positioning preserved);
    MP4 can't carry positioned subtitles, so use MKV or sidecar mode for 3D.

Fixed

• Release notes now fall back to the Unreleased changelog section when a tag
  has no matching ## [X.Y.Z] heading, so notes kept under Unreleased show up in
  the draft instead of a "no entry" placeholder.
• The release workflow no longer overwrites an existing release. Publishing a
  draft re-creates its tag and re-triggers the workflow; it now detects the
  existing release and skips, preserving any manual edits. Delete the release to
  regenerate it.

---

⬇️ Download & run

Grab the archive for your OS from the Assets section below, unpack it, and
run the subtitlegenie executable inside. No Python required.

OS	Archive
🪟 Windows	SubtitleGenie_Win_0.0.4.zip
🍎 MacOS	SubtitleGenie_Mac_0.0.4.tar.gz
🐧 Linux	SubtitleGenie_Linux_0.0.4.tar.gz

First run: subtitlegenie setup to add your free OpenSubtitles API key and
pick your defaults. Then just drop a movie on it. subgenie setup also works!

For embedding subtitles into movies you also need
ffmpeg on your PATH. Saving subtitles as
sidecar files needs nothing extra.

🔗 Links

• 📖 README
• 📋 Full changelog