build(deps): bump electron to 43.8.3, undici to 7.30.1 and follow-redirects to 1.16.1

- Resolve new high-severity audit advisories blocking CI
- Add changelog fragment for patched dependencies

.github/workflows/package-release.yml

@@ -67,26 +67,26 @@ jobs:
       - name: Build unversioned AppImage
         run: |
           shopt -s nullglob
-          appimages=(dist/release/SubMiner-*.AppImage)
+          appimages=(release/SubMiner-*.AppImage)
           if [ "${#appimages[@]}" -eq 0 ]; then
             echo "No versioned AppImage found to create unversioned artifact."
-            ls -la dist/release
+            ls -la release
             exit 1
           fi
-          cp "${appimages[0]}" dist/release/SubMiner.AppImage
+          cp "${appimages[0]}" release/SubMiner.AppImage
 
       - name: Smoke packaged runtime assets
         shell: bash
-        run: xvfb-run -a bun run test:package "dist/release/linux-unpacked/resources"
+        run: xvfb-run -a bun run test:package "release/linux-unpacked/resources"
 
       - name: Upload AppImage artifact
         uses: actions/upload-artifact@v4
         with:
           name: appimage
           path: |
-            dist/release/*.AppImage
-            dist/release/latest*.yml
-            dist/release/*.blockmap
+            release/*.AppImage
+            release/latest*.yml
+            release/*.blockmap
           if-no-files-found: error
 
   build-macos:
@@ -159,17 +159,17 @@ jobs:
 
       - name: Smoke packaged runtime assets
         shell: bash
-        run: bun run test:package "dist/release/mac-arm64/SubMiner.app/Contents/Resources"
+        run: bun run test:package "release/mac-arm64/SubMiner.app/Contents/Resources"
 
       - name: Upload macOS artifacts
         uses: actions/upload-artifact@v4
         with:
           name: macos
           path: |
-            dist/release/*.dmg
-            dist/release/*.zip
-            dist/release/latest*.yml
-            dist/release/*.blockmap
+            release/*.dmg
+            release/*.zip
+            release/latest*.yml
+            release/*.blockmap
           if-no-files-found: error
 
   build-windows:
@@ -224,15 +224,15 @@ jobs:
 
       - name: Smoke packaged runtime assets
         shell: bash
-        run: bun run test:package "dist/release/win-unpacked/resources"
+        run: bun run test:package "release/win-unpacked/resources"
 
       - name: Upload Windows artifacts
         uses: actions/upload-artifact@v4
         with:
           name: windows
           path: |
-            dist/release/*.exe
-            dist/release/*.zip
-            dist/release/latest*.yml
-            dist/release/*.blockmap
+            release/*.exe
+            release/*.zip
+            release/latest*.yml
+            release/*.blockmap
           if-no-files-found: error

.github/workflows/prerelease.yml

@@ -44,19 +44,19 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           name: appimage
-          path: dist/release
+          path: release
 
       - name: Download macOS artifacts
         uses: actions/download-artifact@v4
         with:
           name: macos
-          path: dist/release
+          path: release
 
       - name: Download Windows artifacts
         uses: actions/download-artifact@v4
         with:
           name: windows
-          path: dist/release
+          path: release
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
@@ -90,15 +90,13 @@ jobs:
 
       - name: Package optional assets bundle
         run: |
-          # Keep the archive layout stable for the AUR PKGBUILD.
-          tar -czf "dist/release/subminer-assets.tar.gz" \
-            --transform 's,^packaging/bun/licenses,resources/bun/licenses,' \
+          tar -czf "release/subminer-assets.tar.gz" \
             config.example.jsonc \
             plugin/subminer \
             plugin/subminer.conf \
             assets/themes/subminer.rasi \
             assets/thumbnailers/subminer-ffmpegthumbnailer.thumbnailer \
-            packaging/bun/licenses
+            resources/bun/licenses
 
       - name: Package Bun corresponding source
         run: bun scripts/package-bun-source.mjs
@@ -106,16 +104,16 @@ jobs:
       - name: Generate checksums
         run: |
           shopt -s nullglob
-          files=(dist/release/*.AppImage dist/release/*.dmg dist/release/*.exe dist/release/*.zip dist/release/*.tar.gz dist/release/latest*.yml dist/release/*.blockmap dist/launcher/subminer dist/launcher/subminer.cmd)
+          files=(release/*.AppImage release/*.dmg release/*.exe release/*.zip release/*.tar.gz release/latest*.yml release/*.blockmap dist/launcher/subminer dist/launcher/subminer.cmd)
           if [ "${#files[@]}" -eq 0 ]; then
             echo "No release artifacts found for checksum generation."
             exit 1
           fi
-          : > dist/release/SHA256SUMS.txt
+          : > release/SHA256SUMS.txt
           for file in "${files[@]}"; do
             printf '%s  %s\n' \
               "$(sha256sum "$file" | awk '{print $1}')" \
-              "${file##*/}" >> dist/release/SHA256SUMS.txt
+              "${file##*/}" >> release/SHA256SUMS.txt
           done
 
       - name: Get version from tag
@@ -126,12 +124,12 @@ jobs:
         env:
           RELEASE_VERSION: ${{ steps.version.outputs.VERSION }}
         run: |
-          if [ ! -s packaging/release-notes/prerelease-notes.md ]; then
-            echo "::error::packaging/release-notes/prerelease-notes.md is missing or empty. Run 'bun run changelog:prerelease-notes --version <version>' locally and commit the file before tagging."
+          if [ ! -s release/prerelease-notes.md ]; then
+            echo "::error::release/prerelease-notes.md is missing or empty. Run 'bun run changelog:prerelease-notes --version <version>' locally and commit the file before tagging."
             exit 1
           fi
           if ! bun run changelog:check-prerelease-notes --version "$RELEASE_VERSION"; then
-            echo "::error::packaging/release-notes/prerelease-notes.md was not generated for $RELEASE_VERSION. Rerun 'bun run changelog:prerelease-notes --version $RELEASE_VERSION' locally, commit, and retag."
+            echo "::error::release/prerelease-notes.md was not generated for $RELEASE_VERSION. Rerun 'bun run changelog:prerelease-notes --version $RELEASE_VERSION' locally, commit, and retag."
             exit 1
           fi
 
@@ -144,15 +142,15 @@ jobs:
 
           shopt -s nullglob
           artifacts=(
-            dist/release/*.AppImage
-            dist/release/*.dmg
-            dist/release/*.exe
-            dist/release/*.zip
-            dist/release/*.tar.gz
-            dist/release/*.tar.gz.sha256
-            dist/release/latest*.yml
-            dist/release/*.blockmap
-            dist/release/SHA256SUMS.txt
+            release/*.AppImage
+            release/*.dmg
+            release/*.exe
+            release/*.zip
+            release/*.tar.gz
+            release/*.tar.gz.sha256
+            release/latest*.yml
+            release/*.blockmap
+            release/SHA256SUMS.txt
             dist/launcher/subminer
             dist/launcher/subminer.cmd
           )
@@ -167,14 +165,14 @@ jobs:
               --draft \
               --prerelease \
               --title "$RELEASE_VERSION" \
-              --notes-file packaging/release-notes/prerelease-notes.md
+              --notes-file release/prerelease-notes.md
           else
             gh release create "$RELEASE_VERSION" \
               --draft \
               --latest=false \
               --prerelease \
               --title "$RELEASE_VERSION" \
-              --notes-file packaging/release-notes/prerelease-notes.md
+              --notes-file release/prerelease-notes.md
           fi
 
           for asset in "${artifacts[@]}"; do
@@ -185,4 +183,4 @@ jobs:
             --draft=false \
             --prerelease \
             --title "$RELEASE_VERSION" \
-            --notes-file packaging/release-notes/prerelease-notes.md
+            --notes-file release/prerelease-notes.md

.github/workflows/release.yml

@@ -45,19 +45,19 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           name: appimage
-          path: dist/release
+          path: release
 
       - name: Download macOS artifacts
         uses: actions/download-artifact@v4
         with:
           name: macos
-          path: dist/release
+          path: release
 
       - name: Download Windows artifacts
         uses: actions/download-artifact@v4
         with:
           name: windows
-          path: dist/release
+          path: release
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
@@ -91,15 +91,13 @@ jobs:
 
       - name: Package optional assets bundle
         run: |
-          # Keep the archive layout stable for the AUR PKGBUILD.
-          tar -czf "dist/release/subminer-assets.tar.gz" \
-            --transform 's,^packaging/bun/licenses,resources/bun/licenses,' \
+          tar -czf "release/subminer-assets.tar.gz" \
             config.example.jsonc \
             plugin/subminer \
             plugin/subminer.conf \
             assets/themes/subminer.rasi \
             assets/thumbnailers/subminer-ffmpegthumbnailer.thumbnailer \
-            packaging/bun/licenses
+            resources/bun/licenses
 
       - name: Package Bun corresponding source
         run: bun scripts/package-bun-source.mjs
@@ -107,16 +105,16 @@ jobs:
       - name: Generate checksums
         run: |
           shopt -s nullglob
-          files=(dist/release/*.AppImage dist/release/*.dmg dist/release/*.exe dist/release/*.zip dist/release/*.tar.gz dist/release/latest*.yml dist/release/*.blockmap dist/launcher/subminer dist/launcher/subminer.cmd)
+          files=(release/*.AppImage release/*.dmg release/*.exe release/*.zip release/*.tar.gz release/latest*.yml release/*.blockmap dist/launcher/subminer dist/launcher/subminer.cmd)
           if [ "${#files[@]}" -eq 0 ]; then
             echo "No release artifacts found for checksum generation."
             exit 1
           fi
-          : > dist/release/SHA256SUMS.txt
+          : > release/SHA256SUMS.txt
           for file in "${files[@]}"; do
             printf '%s  %s\n' \
               "$(sha256sum "$file" | awk '{print $1}')" \
-              "${file##*/}" >> dist/release/SHA256SUMS.txt
+              "${file##*/}" >> release/SHA256SUMS.txt
           done
 
       - name: Get version from tag
@@ -154,24 +152,24 @@ jobs:
             gh release edit "$RELEASE_VERSION" \
               --draft=false \
               --title "$RELEASE_VERSION" \
-              --notes-file packaging/release-notes/release-notes.md
+              --notes-file release/release-notes.md
           else
             gh release create "$RELEASE_VERSION" \
               --title "$RELEASE_VERSION" \
-              --notes-file packaging/release-notes/release-notes.md
+              --notes-file release/release-notes.md
           fi
 
           shopt -s nullglob
           artifacts=(
-            dist/release/*.AppImage
-            dist/release/*.dmg
-            dist/release/*.exe
-            dist/release/*.zip
-            dist/release/*.tar.gz
-            dist/release/*.tar.gz.sha256
-            dist/release/latest*.yml
-            dist/release/*.blockmap
-            dist/release/SHA256SUMS.txt
+            release/*.AppImage
+            release/*.dmg
+            release/*.exe
+            release/*.zip
+            release/*.tar.gz
+            release/*.tar.gz.sha256
+            release/latest*.yml
+            release/*.blockmap
+            release/SHA256SUMS.txt
             dist/launcher/subminer
             dist/launcher/subminer.cmd
           )

.gitignore

@@ -8,6 +8,11 @@ node_modules/
 # Electron build output
 out/
 dist/
+release/*
+!release/
+!release/release-notes.md
+!release/prerelease-notes.md
+build/yomitan/
 coverage/
 
 # Launcher build artifact (produced by make build-launcher)
@@ -15,6 +20,8 @@ coverage/
 /main-entry.js
 /main-entry.js.map
 
+/build/hachidori/
+
 # Logs
 *.log
 npm-debug.log*
@@ -36,7 +43,6 @@ environment.toml
 .vitepress/dist/
 docs/.vitepress/cache/
 docs/.vitepress/dist/
-# Local test media and scripts
 tests/*
 .worktrees/
 .tmp/

.prettierignore

@@ -1,9 +1,7 @@
 node_modules
 dist
+release
 coverage
 vendor
 *.log
 src/core/services/tokenizer/__fixtures__/golden/*.json
-# Reviewed release text and vendored license texts; never reformat
-packaging/release-notes
-packaging/bun/licenses

.prettierrc.json

@@ -0,0 +1,5 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "all"
+}

CHANGELOG.md

@@ -1,73 +1,5 @@
 # Changelog
 
-## v0.21.1 (2026-10-26)
-
-### Changed
-- **Stats Session View**: Redesigned the expanded session view in the stats dashboard.
-  - New stat tiles show pace, lines, known-word rate, lookups, and paused time.
-  - A reading density chart of known and unknown words replaces the cumulative chart.
-  - Yomitan lookups and mined cards now appear in their own lane below the chart.
-
-### Fixed
-- **Subtitle Retiming**: Mining, the subtitle sidebar, subtitle navigation, and replay now use the timing you set with mpv's subtitle delay keys (z/x and sub-step), so mined audio and images match the retimed line.
-- **Subtitle Sidebar**: mpv keys and mouse actions, like volume keys and double-click fullscreen, work again while the sidebar is open.
-
-### Docs
-- **README**: Refreshed the anime screenshots using the current build.
-
-<details>
-<summary>Internal changes</summary>
-
-### Internal
-- **Packaging Layout**: Packaging inputs now live under `packaging/`, and all build output lands in `dist/`, with packaged apps in `dist/release/`.
-
-</details>
-
-## v0.21.0 (2026-10-24)
-
-### Added
-- **Hachidori Dictionary Backend**:
-  - Hachidori is now bundled as an alternative to Yomitan. Select it with `dictionaryBackend`, then restart SubMiner.
-  - It works with subtitle scanning, popups, frequency highlighting, character dictionaries, Anki mining, and stats dashboard mining.
-  - First-run setup builds Hachidori's Anki template from your SubMiner settings. It can also link an external Hachidori app, browser, or Docker host.
-  - The tray and dictionary-settings shortcut open settings for the active backend. Use `--hachidori` or `--yomitan` to open a specific one.
-- **Jellyfin Subtitle Generation**: You can now generate Japanese subtitles while playing a Jellyfin episode, with both direct play and transcoded playback.
-
-### Fixed
-- **Jellyfin**:
-  - `subminer jellyfin -p` now lists libraries and shows image previews when SubMiner is already running. Real errors are shown instead of an empty list.
-  - Watch progress from terminal playback is reported to Jellyfin even with cast discovery off.
-  - When `subminer jellyfin -p` starts SubMiner, the app shows its tray icon and quits when mpv closes.
-  - Casting on macOS now finds mpv when SubMiner is opened from Finder, the Dock, or Spotlight.
-- **Halfwidth Katakana**: Halfwidth katakana in subtitles now displays as fullwidth, including in mined cards and older stats lines. Stats sentence search matches katakana in either width.
-- **Media Timing Review**: The review opens on the first attempt instead of after a delay. Playback stays paused while it is open.
-- **Subtitle Annotations**: Lines shown while two cues overlap now get annotations right away. Prefetching no longer restarts during startup.
-- **Keyboard-Only Mode**: `h`, `l`, and the arrow keys now work for typing in modal text fields instead of seeking mpv.
-- **Stats Dashboard Mining**: Cards mined from the stats dashboard keep the selected history line and media.
-- **Hyprland and Sway**: The app no longer freezes when `hyprctl` or `swaymsg` is slow or hangs.
-- **Subtitle Sidebar**: The open sidebar does much less background work during playback.
-- **macOS Launcher Status**: The command-line launcher no longer shows "Not on PATH" when SubMiner is opened from Finder or the Dock.
-- **Security Updates**: Updated Electron, undici, and follow-redirects to address security advisories.
-
-### Docs
-- **Hachidori Setup**: Documented backend selection, Hachidori dictionary and Anki setup, settings shortcuts, and external host linking.
-- **Jellyfin Casting**: Explained when SubMiner joins the cast menu at startup, and how casting finds mpv on each platform. Added a troubleshooting entry for casts that never start mpv.
-- **Jimaku Key**: Removed environment variables that never had any effect. Set the key with `jimaku.apiKey` or `jimaku.apiKeyCommand`.
-
-<details>
-<summary>Internal changes</summary>
-
-### Internal
-- **End-to-End Harness**: Added a headless e2e harness (`bun run test:e2e`, `bun run e2e`) with real mpv, a fixture dictionary, and a fake AnkiConnect.
-- **Hachidori Fork**: The bundled Hachidori integration lives in a pinned fork submodule.
-- **Dead Code Removal**:
-  - Removed the unused launcher Jimaku client, the mpv plugin hover-highlight module, and the unused character dictionary config keys.
-  - Removed 16 unused overlay IPC methods. SubMiner no longer forwards every ASS line to the overlay.
-  - Typecheck now runs with `noUnusedLocals`.
-- **Setup Launcher Label**: First-run setup now labels a missing launcher "Not set up" instead of "Not installed".
-
-</details>
-
 ## v0.20.1 (2026-10-03)
 
 ### Added

Makefile

@@ -21,10 +21,11 @@ MACOS_DATA_DIR ?= $(HOME)/Library/Application Support/SubMiner
 MACOS_APP_DIR ?= $(HOME)/Applications
 MACOS_APP_DEST ?= $(MACOS_APP_DIR)/SubMiner.app
 
-# If building from source, the AppImage will typically land in dist/release/.
-APPIMAGE_SRC = $(firstword $(wildcard dist/release/SubMiner-*.AppImage))
-MACOS_APP_SRC = $(firstword $(wildcard dist/release/*.app dist/release/*/*.app))
-MACOS_ZIP_SRC = $(firstword $(wildcard dist/release/SubMiner-*.zip))
+# If building from source, the AppImage will typically land in release/.
+APPIMAGE_SRC = $(firstword $(wildcard release/SubMiner-*.AppImage))
+MACOS_APP_SRC = $(firstword $(wildcard release/*.app release/*/*.app))
+MACOS_ZIP_SRC = $(firstword $(wildcard release/SubMiner-*.zip))
+PRERELEASE_NOTES := release/prerelease-notes.md
 
 UNAME_S := $(shell uname -s 2>/dev/null || echo Unknown)
 ifeq ($(OS),Windows_NT)
@@ -56,7 +57,7 @@ help:
 		"  build-linux      Build Linux AppImage" \
 		"  build-macos      Build macOS DMG/ZIP (signed if configured)" \
 		"  build-macos-unsigned Build macOS DMG/ZIP without signing/notarization" \
-		"  clean            Remove build artifacts (dist/, AppImage, binary)" \
+		"  clean            Remove build artifacts (dist/, release/, AppImage, binary)" \
 		"  dev-start        Build and launch local Electron app" \
 		"  dev-start-macos  Build and launch local Electron app with macOS tracker backend" \
 		"  dev-watch        Start fast watch loop (tsc + renderer + Electron dev app)" \
@@ -164,7 +165,15 @@ build-launcher:
 
 clean:
 	@printf '%s\n' "[INFO] Removing build artifacts"
-	@rm -rf dist
+	@if [ -f "$(PRERELEASE_NOTES)" ]; then \
+		PRERELEASE_NOTES_BACKUP="$$(mktemp -t subminer-prerelease-notes.XXXXXX)" && \
+		cp "$(PRERELEASE_NOTES)" "$$PRERELEASE_NOTES_BACKUP" && \
+		rm -rf dist release && \
+		install -d release && \
+		mv "$$PRERELEASE_NOTES_BACKUP" "$(PRERELEASE_NOTES)"; \
+	else \
+		rm -rf dist release; \
+	fi
 	@rm -f "$(BINDIR)/subminer" "$(BINDIR)/SubMiner.AppImage"
 
 generate-config: ensure-bun
@@ -220,7 +229,7 @@ install-linux: build-launcher
 	@if [ -n "$(APPIMAGE_SRC)" ]; then \
 		install -m 0755 "$(APPIMAGE_SRC)" "$(BINDIR)/SubMiner.AppImage"; \
 	else \
-		printf '%s\n' "[WARN] No dist/release/SubMiner-*.AppImage found; skipping AppImage install"; \
+		printf '%s\n' "[WARN] No release/SubMiner-*.AppImage found; skipping AppImage install"; \
 		printf '%s\n' "       Build one with: make build"; \
 	fi
 	@printf '%s\n' "Installed to:" "  $(BINDIR)/subminer" "  $(LINUX_DATA_DIR)/themes/$(THEME_FILE)" "  $(LINUX_DATA_DIR)/thumbnailers/$(THUMBNAILER_FILE)"
@@ -243,7 +252,7 @@ install-macos: build-launcher
 		ditto -x -k "$(MACOS_ZIP_SRC)" "$(MACOS_APP_DIR)"; \
 		printf '%s\n' "[INFO] Installed app bundle from $(MACOS_ZIP_SRC)"; \
 	else \
-		printf '%s\n' "[WARN] No macOS app bundle or zip found in dist/release/; skipping app install"; \
+		printf '%s\n' "[WARN] No macOS app bundle or zip found in release/; skipping app install"; \
 		printf '%s\n' "       Build one with: make build"; \
 	fi
 	@printf '%s\n' "Installed to:" "  $(BINDIR)/subminer" "  $(MACOS_DATA_DIR)/themes/$(THEME_FILE)" "  $(MACOS_APP_DEST)"

README.md

@@ -25,7 +25,7 @@ Look up words with Yomitan or Hachidori, mine them to Anki, and track your immer
 
 Hover over any word in the subtitles to open the full Yomitan popup with definitions, pitch accent, and frequency data. SubMiner bundles its own Yomitan, separate from any browser install.
 
-Yomitan remains the default. Select the bundled [Hachidori](https://github.com/bee-san/hachidori) backend with `dictionaryBackend: "hachidori"` and restart SubMiner. The tray opens the selected backend's settings. See [dictionary setup](https://docs.subminer.moe/usage#hachidori-setup) for importing dictionaries, linking an external Hachidori host, and configuring Anki.
+Yomitan remains the default. Select the bundled Hachidori backend with `dictionaryBackend: "hachidori"` and restart SubMiner. The tray opens the selected backend's settings. See [dictionary setup](https://docs.subminer.moe/usage#hachidori-setup) for importing dictionaries, linking an external Hachidori host, and configuring Anki.
 
 <div align="center">
   <img src="docs-site/public/screenshots/yomitan-lookup.png" width="800" alt="Yomitan dictionary popup over annotated subtitles in mpv">
@@ -38,7 +38,7 @@ Yomitan remains the default. Select the bundled [Hachidori](https://github.com/b
 Create an Anki card from the exact playback moment with one key press, click, or controller input. SubMiner fills in the sentence, an audio clip, and a screenshot or animated image.
 
 <div align="center">
-  <img src="docs-site/public/screenshots/one-key-mining.png" width="800" alt="Yomitan lookup over an anime scene with Anki mining controls">
+  <img src="docs-site/public/screenshots/one-key-mining.png" width="800" alt="Anki card created from SubMiner with sentence, audio, and screenshot">
 </div>
 
 <br>
@@ -48,7 +48,7 @@ Create an Anki card from the exact playback moment with one key press, click, or
 Subtitles are annotated as they play with frequency highlighting, JLPT tags, N+1 targeting, and character names from a generated dictionary. Particles and grammar-only tokens stay plain so the words worth learning stand out.
 
 <div align="center">
-  <img src="docs-site/public/screenshots/annotations.png" width="800" alt="Annotated subtitles with frequency colors, character portraits, and JLPT underlines">
+  <img src="docs-site/public/screenshots/annotations.png" width="800" alt="Annotated subtitles with frequency coloring, JLPT underlines, and N+1 targets">
 </div>
 
 <br>
@@ -201,7 +201,7 @@ The AppImage is all you need. First-run setup can install the optional `subminer
 
 Download the latest DMG from [GitHub Releases](https://github.com/ksyasuda/SubMiner/releases/latest) and drag `SubMiner.app` into `/Applications`.
 
-Then enable SubMiner under **System Settings > Privacy & Security > Accessibility** (named **Device Control and Data Access** on macOS 27) so the overlay can track the mpv window. Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized. If macOS blocks the first launch, right-click the app and choose **Open**.
+Then enable SubMiner under **System Settings > Privacy & Security > Accessibility**, or the overlay cannot follow the mpv window. If macOS blocks the first launch, right-click the app and choose **Open**.
 
 </details>
 

build/bun-runtime-manifest.json

@@ -26,6 +26,6 @@
     }
   },
   "licenseInventoryStatus": "source-and-notices-pinned-to-binary-revision",
-  "sourceManifest": "packaging/bun/bun-source-manifest.json",
+  "sourceManifest": "build/bun-source-manifest.json",
   "correspondingSourceAsset": "bun-v1.3.5-source.tar.gz"
 }

changes/README.md

@@ -44,11 +44,11 @@ How fragments turn into a release:
 - The polish step treats pending fragments as the final release outcome, not prerelease history. If a feature is added and then renamed or fixed before the stable cut, ship the final feature bullet instead of separate prerelease-only breaking/fix entries.
 - `CHANGELOG.md`, GitHub release notes, and prerelease notes all use one item per feature or area, inline by default: `- **Name**: one or two short sentences.` Items with several separate changes may use a few short nested bullets instead of a run-on sentence. Items say what changed and how to reach it; implementation details, edge cases, and step-by-step usage belong in the docs, not the release body.
 - `internal` fragments stay in `CHANGELOG.md` (inside a collapsed `<details>` block) but are dropped from the GitHub release notes entirely.
-- The polished `CHANGELOG.md` and `packaging/release-notes/release-notes.md` are committed and reviewed before tagging — edit the Markdown by hand if Claude misses something.
+- The polished `CHANGELOG.md` and `release/release-notes.md` are committed and reviewed before tagging — edit the Markdown by hand if Claude misses something.
 
 Prerelease notes:
 
-- prerelease tags like `v0.11.3-beta.1` and `v0.11.3-rc.1` reuse the current pending fragments to generate `packaging/release-notes/prerelease-notes.md`
+- prerelease tags like `v0.11.3-beta.1` and `v0.11.3-rc.1` reuse the current pending fragments to generate `release/prerelease-notes.md`
 - from the second prerelease of a base version onward, the notes also open with a `## Changes since <previous tag>` section generated from the fragment diff against the previous beta/RC tag; keep fragment edits meaningful. Editorial-only rewording is filtered out of that section, while genuinely changed behavior and deleted fragments (reverted changes) are reported
 - existing prerelease notes are a reviewed baseline; later prerelease runs should replace stale beta/RC wording with the current outcome instead of appending fix churn
 - prerelease note generation does not consume fragments and does not update `CHANGELOG.md` or `docs-site/changelog.md`

changes/e2e-harness.md

@@ -0,0 +1,4 @@
+type: internal
+area: testing
+
+- Added a headless end-to-end harness (`bun run test:e2e`, `bun run e2e`) that boots the built app with a real mpv, a synthetic clip, a fixture Yomitan dictionary, and a fake AnkiConnect on an offscreen display.

changes/fix-timing-review-playback-hold.md

@@ -0,0 +1,4 @@
+type: fixed
+area: anki
+
+- Media timing review now keeps playback paused while it is open when the dictionary popup or subtitle hover pause ends, as with Hachidori popups closing when the review appears. Playback resumes after the review closes unless a dictionary popup is still open.

changes/hachidori-backend.md

@@ -0,0 +1,15 @@
+type: added
+area: dictionary
+
+- Added a bundled Hachidori dictionary backend alongside the default Yomitan backend. Select it with `dictionaryBackend` and restart SubMiner.
+- The tray and dictionary-settings shortcut follow the selected backend. `--hachidori` opens Hachidori settings, while `--yomitan` opens Yomitan settings unless a read-only external Yomitan profile is configured. This restriction also applies with Hachidori active, without blocking Hachidori settings.
+- Hachidori integrates with subtitle scanning, popup controls, lookup tracking, character dictionaries, and Anki media enrichment, with separate dictionaries and settings for each backend. Character dictionaries reach a linked host over the link (Hachidori 0.2.3 or later, or a current Docker host), retry busy imports, and replace the previous dictionary only after a successful import. Older hosts report where to import the dictionary manually.
+- Hachidori auto-populates its first Anki template from SubMiner's deck, tags (kept alongside its own `hachidori` tag), and field mappings, detects an unambiguous matching note type, and preserves existing custom templates apart from the deck, which follows `ankiConnect.deck` so polling mode enriches Hachidori cards. Anki discovery retries after an unavailable connection.
+- Hachidori saves downloadable word audio before sending a note through SubMiner's Anki proxy, so freshly mined animated cards include the word-audio delay.
+- Both bundled dictionary backends reload their background code on startup so extension updates take effect while preserving installed dictionaries and settings. Failed Yomitan connection-setting updates can be retried without manually resetting the managed Anki endpoint.
+- First-run setup remembers each backend that finished it, including when reopened for legacy plugin cleanup, so switching back does not repeat setup, and the launcher gates playback on the backend the running app started with. Current incomplete or cancelled setup takes precedence over stale completion history. A running Yomitan session keeps using its external profile until it restarts into Hachidori.
+- Stats dashboard mining and deck lookup use the selected backend, with the Anki proxy enabled or disabled. Dashboard cards retain the selected history line and media instead of being processed again with the current mpv subtitle, with both Yomitan and Hachidori. Stats cards carry a `SubMiner::Stats` tag so polling also preserves their context. Hachidori word mining supplies dictionary aliases, IDs, and frequency metadata to its native Anki renderer. Settings labels for popup pause and the dictionary deck no longer name Yomitan, and the backend selector sits with the other dictionary settings.
+- Hachidori scans, dictionary counts, and settings reads wait for the dictionary engine to finish loading or importing instead of caching empty results.
+- Character dictionary imports report completion as soon as the archive is read instead of waiting out the temporary server's keep-alive timeout.
+- First-run setup can link an external Hachidori dictionary host in an app, browser, or Docker container, verify its library, and unlink back to local dictionaries. The optional host controls are collapsed by default and explain which apps or containers must stay running. Unresponsive connection checks time out so setup remains usable. Anki mining, media enrichment, and custom toolbar buttons stay in SubMiner, including when editing buttons while linked.
+- Hachidori frequency highlighting reuses dictionary-entry ranks and fills missing ranks through its existing API. Entries without a matching definition may remain unranked. The bundled integration is maintained in a pinned fork submodule using upstream HoshiDicts and WASM binaries.

changes/hachidori-setup-docs.md

@@ -0,0 +1,4 @@
+type: docs
+area: dictionary
+
+- Documented backend selection, separate Hachidori dictionary and Anki setup, the settings flags and shortcuts, and external host linking with local Anki mining and the running requirements for each host type.

changes/jellyfin-cli-running-app.md

@@ -0,0 +1,7 @@
+type: fixed
+area: jellyfin
+
+- Fixed `subminer jellyfin -p` reporting "No Jellyfin libraries found." when SubMiner was already running (for example right after `subminer jellyfin` login). The app now hands library, item, and preview-auth results to the launcher directly instead of through log files, so picker image previews work again and real errors (expired session, unreachable server) are shown instead of an empty list.
+- The rofi "Jellyfin Search (optional)" step after picking a library is now a compact input box with a "Type to search, or press Enter to browse all" hint instead of a blank list.
+- Playing from the terminal (`subminer jellyfin -p`) now reports watch progress to Jellyfin even when cast discovery is off, so Jellyfin remembers where you stopped and marks finished episodes as played. Previously progress was only sent while the cast connection was active.
+- When `subminer jellyfin -p` has to start SubMiner itself, the app now shows its tray icon and quits when you close mpv, the same as playing a local file. Before, it had no tray icon and kept running hidden after playback. A SubMiner that was already running is still reused and left running.

changes/jellyfin-startup-connect-docs.md

@@ -0,0 +1,4 @@
+type: docs
+area: jellyfin
+
+- Corrected the Jellyfin docs: SubMiner only joins the cast menu at startup when `startupWarmups.jellyfinRemoteSession` is on (off by default) along with `jellyfin.remoteControlAutoConnect`. Otherwise tick **Jellyfin Discovery** in the tray.

changes/jellyfin-subtitle-generation.md

@@ -0,0 +1,4 @@
+type: added
+area: subtitles
+
+- Japanese subtitle generation now works while playing a Jellyfin episode. SubMiner reads the original file from the server, saves the subtitles to a cache folder, and loads them into mpv. Direct-play and transcoded playback are both supported.

changes/keyboard-mode-modal-input.md

@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- Keyboard-only mode no longer swallows `h`, `l`, and the left/right arrows while a modal is open or a text field has focus, so typing into fields like the Jimaku or TsukiHime title works and no longer seeks mpv. Pressing `Ctrl/Cmd+Shift+Y` (or the controller toggle) inside a modal no longer turns on a hidden keyboard-only mode in the modal window.

changes/macos-login-shell-path.md

@@ -0,0 +1,4 @@
+type: fixed
+area: setup
+
+- Fixed the command-line launcher showing "Not on PATH" on macOS when SubMiner was opened from Finder or the Dock, even though the launcher directory was already on your terminal PATH.

changes/overlay-modal-first-open.md

@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- Overlay modals such as the media timing review open on the first attempt when their dedicated window is created on demand, instead of after a four-second retry.

changes/patched-electron-undici-follow-redirects.md

@@ -0,0 +1,4 @@
+type: fixed
+area: dependencies
+
+- Updated Electron to 43.8.3 and undici to 7.30.1, and pinned follow-redirects to 1.16.1, to resolve new security advisories.

changes/prefetch-startup-restarts.md

@@ -0,0 +1,5 @@
+type: fixed
+area: annotations
+
+- Subtitle lines shown while two cues overlap (common in Jimaku and Jellyfin SRTs, and usually the long lines) are now prefetched, so their annotations appear immediately instead of after a delay.
+- Subtitle prefetching no longer restarts each time the same subtitle file is re-selected during startup, and a line tokenized before a restart or seek is kept instead of discarded.

changes/remove-dead-code-docs.md

@@ -0,0 +1,4 @@
+type: docs
+area: launcher
+
+- Removed `SUBMINER_JIMAKU_API_KEY`, `SUBMINER_JIMAKU_API_KEY_COMMAND`, and `SUBMINER_JIMAKU_API_BASE_URL` from the development docs' environment variable table. The launcher never used them; set the Jimaku key with `jimaku.apiKey` / `jimaku.apiKeyCommand` in the config instead.

changes/remove-dead-code.md

@@ -0,0 +1,5 @@
+type: internal
+area: cleanup
+
+- Removed dead code: the unused launcher Jimaku client (the `SUBMINER_JIMAKU_*` env vars it read were documented but had no effect), the mpv plugin's hover-highlight module (no sender since Overlay 2.0; custom mpv scripts that still send `subminer-hover-token` or `yomipv-hover-token` are now ignored), the never-read `anilist.characterDictionary.refreshTtlHours` / `evictionPolicy` config keys, unused root dependencies (eslint, geist fonts), and a committed draft plan doc.
+- Typecheck now runs with `noUnusedLocals`; removed the unused locals, imports, and the Windows overlay focus-handoff values they fed, which were computed but never used.

changes/remove-dead-ipc.md

@@ -0,0 +1,4 @@
+type: internal
+area: overlay
+
+- Removed 16 overlay preload/IPC methods that nothing called, plus their main-process handlers. SubMiner no longer observes mpv's `sub-text/ass` or sends every ASS line to overlay windows that never listened.

changes/setup-launcher-badge-label.md

@@ -0,0 +1,4 @@
+type: fixed
+area: setup
+
+- First-run setup now labels a missing command-line launcher "Not set up" instead of "Not installed", so the AppImage catalog test no longer reads the setup window as an error screen.

changes/sidebar-snapshot-poll.md

@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- The open subtitle sidebar no longer re-fetches the whole subtitle list and re-queries mpv about 12 times a second. It polls only the current time and line, and reloads the list when the subtitle track, file, or parsed cues change (plus a slow ~2 s fallback), cutting idle sidebar IPC and renderer work during playback.

changes/stats-widen-halfwidth-kana.md

@@ -0,0 +1,5 @@
+type: fixed
+area: stats
+
+- Subtitle lines recorded before halfwidth katakana widening now show fullwidth katakana in the stats dashboard (word/kanji occurrences, sentence search), and cards mined from stats history get the fullwidth sentence and word.
+- Sentence search matches katakana in either width, so searching アンタ also finds older lines stored as ｱﾝﾀ.

changes/tracker-async-poll.md

@@ -0,0 +1,5 @@
+type: fixed
+area: overlay
+
+- Hyprland and Sway window tracking no longer freezes the app when `hyprctl` or `swaymsg` is slow or hangs: polls now run in the background with a timeout and no longer pile up.
+- The Hyprland/Sway trackers read each mpv process's command line once instead of spawning `ps` on every poll.

changes/widen-halfwidth-kana.md

@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- Halfwidth katakana in subtitles (common in broadcast-derived Japanese subs, e.g. ｱﾝﾀ, ﾀﾞｷﾆ) now displays as normal fullwidth katakana, so lines no longer mix squashed and normal-width text. Mined sentences and stats get the fullwidth form too.

config.example.jsonc

@@ -741,10 +741,10 @@
   // autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.
   // Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.
   // Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.
-  // Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.
+  // Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.
   // ==========================================
   "mpv": {
-    "executablePath": "", // Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.
+    "executablePath": "", // Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.
     "launchMode": "normal", // Default window state for SubMiner-managed mpv launches. Values: normal | maximized | fullscreen
     "profile": "", // Optional mpv profile name passed to SubMiner-managed mpv launches. Leave empty to pass no profile.
     "socketPath": "/tmp/subminer-socket", // mpv IPC socket path used by SubMiner-managed playback and the bundled mpv plugin.

docs-site/changelog.md

@@ -1,79 +1,6 @@
 # Changelog
 
-## v0.21.1 (2026-10-26)
-
-**Changed**
-- **Stats Session View**: Redesigned the expanded session view in the stats dashboard.
-  - New stat tiles show pace, lines, known-word rate, lookups, and paused time.
-  - A reading density chart of known and unknown words replaces the cumulative chart.
-  - Yomitan lookups and mined cards now appear in their own lane below the chart.
-
-**Fixed**
-- **Subtitle Retiming**: Mining, the subtitle sidebar, subtitle navigation, and replay now use the timing you set with mpv's subtitle delay keys (z/x and sub-step), so mined audio and images match the retimed line.
-- **Subtitle Sidebar**: mpv keys and mouse actions, like volume keys and double-click fullscreen, work again while the sidebar is open.
-
-**Docs**
-- **README**: Refreshed the anime screenshots using the current build.
-
-<details>
-<summary>Internal changes</summary>
-
-**Internal**
-- **Packaging Layout**: Packaging inputs now live under `packaging/`, and all build output lands in `dist/`, with packaged apps in `dist/release/`.
-
-</details>
-
-## v0.21.0 (2026-10-24)
-
-**Added**
-- **Hachidori Dictionary Backend**:
-  - Hachidori is now bundled as an alternative to Yomitan. Select it with `dictionaryBackend`, then restart SubMiner.
-  - It works with subtitle scanning, popups, frequency highlighting, character dictionaries, Anki mining, and stats dashboard mining.
-  - First-run setup builds Hachidori's Anki template from your SubMiner settings. It can also link an external Hachidori app, browser, or Docker host.
-  - The tray and dictionary-settings shortcut open settings for the active backend. Use `--hachidori` or `--yomitan` to open a specific one.
-- **Jellyfin Subtitle Generation**: You can now generate Japanese subtitles while playing a Jellyfin episode, with both direct play and transcoded playback.
-
-**Fixed**
-- **Jellyfin**:
-  - `subminer jellyfin -p` now lists libraries and shows image previews when SubMiner is already running. Real errors are shown instead of an empty list.
-  - Watch progress from terminal playback is reported to Jellyfin even with cast discovery off.
-  - When `subminer jellyfin -p` starts SubMiner, the app shows its tray icon and quits when mpv closes.
-  - Casting on macOS now finds mpv when SubMiner is opened from Finder, the Dock, or Spotlight.
-- **Halfwidth Katakana**: Halfwidth katakana in subtitles now displays as fullwidth, including in mined cards and older stats lines. Stats sentence search matches katakana in either width.
-- **Media Timing Review**: The review opens on the first attempt instead of after a delay. Playback stays paused while it is open.
-- **Subtitle Annotations**: Lines shown while two cues overlap now get annotations right away. Prefetching no longer restarts during startup.
-- **Keyboard-Only Mode**: `h`, `l`, and the arrow keys now work for typing in modal text fields instead of seeking mpv.
-- **Stats Dashboard Mining**: Cards mined from the stats dashboard keep the selected history line and media.
-- **Hyprland and Sway**: The app no longer freezes when `hyprctl` or `swaymsg` is slow or hangs.
-- **Subtitle Sidebar**: The open sidebar does much less background work during playback.
-- **macOS Launcher Status**: The command-line launcher no longer shows "Not on PATH" when SubMiner is opened from Finder or the Dock.
-- **Security Updates**: Updated Electron, undici, and follow-redirects to address security advisories.
-
-**Docs**
-- **Hachidori Setup**: Documented backend selection, Hachidori dictionary and Anki setup, settings shortcuts, and external host linking.
-- **Jellyfin Casting**: Explained when SubMiner joins the cast menu at startup, and how casting finds mpv on each platform. Added a troubleshooting entry for casts that never start mpv.
-- **Jimaku Key**: Removed environment variables that never had any effect. Set the key with `jimaku.apiKey` or `jimaku.apiKeyCommand`.
-
-<details>
-<summary>Internal changes</summary>
-
-**Internal**
-- **End-to-End Harness**: Added a headless e2e harness (`bun run test:e2e`, `bun run e2e`) with real mpv, a fixture dictionary, and a fake AnkiConnect.
-- **Hachidori Fork**: The bundled Hachidori integration lives in a pinned fork submodule.
-- **Dead Code Removal**:
-  - Removed the unused launcher Jimaku client, the mpv plugin hover-highlight module, and the unused character dictionary config keys.
-  - Removed 16 unused overlay IPC methods. SubMiner no longer forwards every ASS line to the overlay.
-  - Typecheck now runs with `noUnusedLocals`.
-- **Setup Launcher Label**: First-run setup now labels a missing launcher "Not set up" instead of "Not installed".
-
-</details>
-
-## Previous Versions
-
-<details>
-<summary>v0.20.x</summary>
-
-<h2>v0.20.1 (2026-10-03)</h2>
+## v0.20.1 (2026-10-03)
 
 **Added**
 - **YouTube Browser Window**:
@@ -123,7 +50,7 @@
 
 </details>
 
-<h2>v0.20.0 (2026-09-23)</h2>
+## v0.20.0 (2026-09-23)
 
 **Added**
 - **Japanese Subtitle Generation**:
@@ -244,7 +171,7 @@
 
 </details>
 
-</details>
+## Previous Versions
 
 <details>
 <summary>v0.19.x</summary>

docs-site/configuration.md

@@ -585,18 +585,18 @@ A local web dashboard at `http://127.0.0.1:<serverPort>`, also available as an o
 
 Settings for mpv instances that SubMiner starts, and for the bundled mpv plugin. See [mpv plugin](/mpv-plugin).
 
-| Key                          | Default           | What it does                                                                                            |
-| ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------- |
-| `mpv.executablePath`         | `""`              | Full path to mpv. Empty auto-discovers it ([lookup order](/jellyfin-integration#casting-from-jellyfin)) |
-| `mpv.launchMode`             | `"normal"`        | Window state: `normal`, `maximized`, or `fullscreen`                                                    |
-| `mpv.profile`                | `""`              | mpv profile to pass. Combined with a launcher `--profile` if both are set                               |
-| `mpv.socketPath`             | platform-specific | mpv IPC socket. See the warning under [Config file](#configuration-file)                                |
-| `mpv.backend`                | `"auto"`          | Window tracking: `auto`, `hyprland`, `sway`, `x11`, `macos`, `windows`                                  |
-| `mpv.autoStartSubMiner`      | `true`            | Start SubMiner in the background when mpv loads a file                                                  |
-| `mpv.pauseUntilOverlayReady` | `true`            | Keep mpv paused until subtitles are ready, up to 30 seconds                                             |
-| `mpv.subminerBinaryPath`     | `""`              | SubMiner app path for the plugin. Empty uses the detected path                                          |
-| `mpv.aniskipEnabled`         | `true`            | Detect intros with AniSkip and show a skip prompt                                                       |
-| `mpv.aniskipButtonKey`       | `"TAB"`           | mpv key that skips the intro while the prompt is shown                                                  |
+| Key                          | Default           | What it does                                                                |
+| ---------------------------- | ----------------- | --------------------------------------------------------------------------- |
+| `mpv.executablePath`         | `""`              | Path to `mpv.exe` on Windows. Empty checks `SUBMINER_MPV_PATH`, then `PATH` |
+| `mpv.launchMode`             | `"normal"`        | Window state: `normal`, `maximized`, or `fullscreen`                        |
+| `mpv.profile`                | `""`              | mpv profile to pass. Combined with a launcher `--profile` if both are set   |
+| `mpv.socketPath`             | platform-specific | mpv IPC socket. See the warning under [Config file](#configuration-file)    |
+| `mpv.backend`                | `"auto"`          | Window tracking: `auto`, `hyprland`, `sway`, `x11`, `macos`, `windows`      |
+| `mpv.autoStartSubMiner`      | `true`            | Start SubMiner in the background when mpv loads a file                      |
+| `mpv.pauseUntilOverlayReady` | `true`            | Keep mpv paused until subtitles are ready, up to 30 seconds                 |
+| `mpv.subminerBinaryPath`     | `""`              | SubMiner app path for the plugin. Empty uses the detected path              |
+| `mpv.aniskipEnabled`         | `true`            | Detect intros with AniSkip and show a skip prompt                           |
+| `mpv.aniskipButtonKey`       | `"TAB"`           | mpv key that skips the intro while the prompt is shown                      |
 
 ### YouTube playback settings
 

docs-site/immersion-tracking.md

@@ -70,7 +70,7 @@ Charts for watch time, cards, words, and sessions per day or month, running tota
 
 ### Sessions
 
-Session history. Expand a session for its pace, lines, known-word rate, lookups, and paused time, plus a reading density chart of known and unknown words over the session with Yomitan lookup ticks and clickable card-mined markers underneath. The **↗** button on a row opens that show's detail view.
+Session history with new-word activity and pause, seek, and card markers. The **↗** button on a row opens that show's detail view.
 
 ![Stats Sessions](/screenshots/stats-sessions.png)
 

docs-site/installation.md

@@ -187,7 +187,7 @@ First-run setup can install the `subminer` command for you.
    xattr -d com.apple.quarantine /Applications/SubMiner.app
    ```
 
-3. Open **System Settings > Privacy & Security > Accessibility** and enable SubMiner (add it if it is missing). On macOS 27 this list is named **Device Control and Data Access**. SubMiner uses it to track the mpv window. Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized.
+3. Open **System Settings > Privacy & Security > Accessibility** and enable SubMiner (add it if it is missing). The overlay cannot follow the mpv window without this.
 
 First-run setup can install the `subminer` command for you.
 
@@ -226,7 +226,7 @@ make deps
 make build-macos
 ```
 
-The `.dmg` and `.zip` land in `dist/release/`. For an unsigned local build, run `bun run build:mac:unsigned`.
+The `.dmg` and `.zip` land in `release/`. For an unsigned local build, run `bun run build:mac:unsigned`.
 
 </details>
 

docs-site/jellyfin-integration.md

@@ -25,7 +25,7 @@ SubMiner selects a Japanese subtitle track automatically and resets mpv's subtit
 
 If an episode has no Japanese subtitles, you can [generate them with Whisper](/subtitle-generation#generating-from-the-overlay) while it plays.
 
-Casting finds mpv through `mpv.executablePath`, then `SUBMINER_MPV_PATH`, then `PATH`. On macOS it then checks `/opt/homebrew/bin/mpv`, `/usr/local/bin/mpv`, and `/Applications/mpv.app`, because an app opened from Finder, the Dock, or Spotlight does not get your shell's `PATH`. If mpv lives somewhere else, set `mpv.executablePath` to its full path (`command -v mpv` prints it). An invalid `mpv.executablePath` stops mpv from starting.
+On Windows, casting finds mpv through `mpv.executablePath`, then `SUBMINER_MPV_PATH`, then `PATH`. An invalid `mpv.executablePath` stops mpv from starting.
 
 ## Playing from the terminal
 

docs-site/public/config.example.jsonc

@@ -741,10 +741,10 @@
   // autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.
   // Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.
   // Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.
-  // Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.
+  // Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.
   // ==========================================
   "mpv": {
-    "executablePath": "", // Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.
+    "executablePath": "", // Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.
     "launchMode": "normal", // Default window state for SubMiner-managed mpv launches. Values: normal | maximized | fullscreen
     "profile": "", // Optional mpv profile name passed to SubMiner-managed mpv launches. Leave empty to pass no profile.
     "socketPath": "/tmp/subminer-socket", // mpv IPC socket path used by SubMiner-managed playback and the bundled mpv plugin.

docs-site/troubleshooting.md

@@ -39,18 +39,11 @@ SubMiner reads subtitles from mpv over an IPC socket (a named pipe on Windows).
 
 SubMiner reconnects on its own if mpv restarts.
 
-## Casting from Jellyfin does nothing
-
-When `connect ENOENT /tmp/subminer-socket` follows a cast in the app log, SubMiner could not start mpv, so the socket never appeared. Look for `Failed handling Jellyfin remote Play event` or `Failed to launch mpv for Jellyfin remote playback` just before it.
-
-- Check that `mpv --version` works in a terminal.
-- If it does, SubMiner is not finding mpv where it is installed. Set `mpv.executablePath` to the output of `command -v mpv`. See [Casting from Jellyfin](/jellyfin-integration#casting-from-jellyfin) for where SubMiner looks.
-
 ## Overlay does not appear
 
 - Confirm SubMiner is running (`SubMiner.AppImage --start`, or check for the process).
 - Linux: Hyprland and Sway work natively. Any other compositor needs mpv and SubMiner under X11 or Xwayland, with `xdotool`, `xprop`, and `xwininfo` installed. See [KDE Plasma and other Wayland compositors](#kde-plasma-and-other-wayland-compositors).
-- macOS: grant Accessibility permission. See [macOS](#macos).
+- macOS: grant Accessibility permission in System Settings > Privacy & Security > Accessibility.
 
 ## Overlay is on the wrong monitor or position
 
@@ -86,7 +79,7 @@ SubMiner detected that a previously non-empty Yomitan profile suddenly appears e
 
 ## "Yomitan extension not found in any search path"
 
-The bundled Yomitan is missing. Re-download the AppImage, or place an unpacked Yomitan extension in `~/.config/SubMiner/yomitan`. Source builds must run `bun run build` first to produce `dist/yomitan`.
+The bundled Yomitan is missing. Re-download the AppImage, or place an unpacked Yomitan extension in `~/.config/SubMiner/yomitan`. Source builds must run `bun run build` first to produce `build/yomitan`.
 
 ## "MeCab not found on system"
 
@@ -262,5 +255,5 @@ mpv --gpu-context=x11vk,x11egl,x11 video.mkv
 
 ## macOS
 
-- Grant Accessibility permission under System Settings > Privacy & Security > Accessibility (named **Device Control and Data Access** on macOS 27). Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized.
+- Accessibility permission is required for window tracking: System Settings > Privacy & Security > Accessibility.
 - If Gatekeeper blocks the app, right-click it and choose Open, or run `xattr -d com.apple.quarantine /path/to/SubMiner.app`.

docs-site/usage.md

@@ -22,7 +22,7 @@ The bundled Yomitan is separate from any Yomitan in your browser. It has its own
 
 ### Hachidori setup
 
-[Hachidori](https://github.com/bee-san/hachidori) is an alternative lookup backend. Set `dictionaryBackend` to `"hachidori"` in settings or `config.jsonc`, then restart SubMiner. Set it back to `"yomitan"` and restart to switch back.
+Hachidori is an alternative lookup backend. Set `dictionaryBackend` to `"hachidori"` in settings or `config.jsonc`, then restart SubMiner. Set it back to `"yomitan"` and restart to switch back.
 
 Open Hachidori settings with `Alt+Shift+Y`, the tray's **Open Hachidori Settings**, or `subminer app --hachidori`. Import dictionary ZIPs or use Hachidori's recommended dictionary installer, then set up its Anki template (SubMiner [fills in what it can](/anki-integration#hachidori-settings-from-subminer)). Yomitan and Hachidori keep separate dictionaries and settings. Yomitan profiles, custom Handlebars templates, and `yomitan.externalProfilePath` do not carry over. Subtitle annotations and lookups wait while Hachidori imports a dictionary, so large imports pause them until the import finishes.
 

docs/RELEASING.md

@@ -54,10 +54,10 @@ files before signing and generating updater hashes, never from a signed app.
 4. Bump `package.json` to the release version.
 5. Build release metadata before tagging (this calls `claude -p` locally):
    `bun run changelog:build --version <version> --date <yyyy-mm-dd>`
-   - The polished `CHANGELOG.md` and `packaging/release-notes/release-notes.md` are committed
+   - The polished `CHANGELOG.md` and `release/release-notes.md` are committed
      before tagging. Release CI no longer auto-builds the changelog; it fails
      fast if `changes/*.md` fragments are still present on a tag-based run.
-6. Review `CHANGELOG.md` and `packaging/release-notes/release-notes.md`. Edit by hand if Claude
+6. Review `CHANGELOG.md` and `release/release-notes.md`. Edit by hand if Claude
    missed something — the committed Markdown is what ships.
 7. Run release gate locally:
    `bun run changelog:check --version <version>`
@@ -73,9 +73,9 @@ files before signing and generating updater hashes, never from a signed app.
    `bun-v<version>-source.tar.gz` plus its `.sha256` file. The script
    fails if Bun's CMake dependency pins, WebKit pin, source checksums, patch
    inputs, or collected license files differ from
-   `packaging/bun/bun-source-manifest.json`.
+   `build/bun-source-manifest.json`.
    When validating auto-update metadata, also run the relevant platform package
-   build and confirm `dist/release/` contains the generated updater metadata
+   build and confirm `release/` contains the generated updater metadata
    (`latest*.yml`) and blockmaps (`*.blockmap`).
 8. If `docs-site/` changed, also run:
    `bun run docs:test`
@@ -103,9 +103,9 @@ files before signing and generating updater hashes, never from a signed app.
    source archive. A missing source repository or license file fails the
    release instead of publishing only the executable.
    When validating packaged updater output, confirm the platform build writes
-   `latest*.yml` and `*.blockmap` files under `dist/release/`.
+   `latest*.yml` and `*.blockmap` files under `release/`.
 5. Commit the prerelease prep (package.json version bump + the generated
-   `packaging/release-notes/prerelease-notes.md`). CI does not regenerate notes — it uses the
+   `release/prerelease-notes.md`). CI does not regenerate notes — it uses the
    committed file — so review it before committing. Rerun
    `bun run changelog:prerelease-notes --version <version>` for every later
    beta/RC, even if no fragments changed: the notes carry a hidden
@@ -128,14 +128,14 @@ Notes:
 - Supported prerelease channels are `beta` and `rc`, with versions like `0.11.3-beta.1` and `0.11.3-rc.1`.
 - Pass `--date` explicitly when you want the release stamped with the local cut date; otherwise the generator uses the current ISO date, which can roll over to the next UTC day late at night.
 - `changelog:check` now rejects tag/package version mismatches.
-- `changelog:prerelease-notes` also rejects tag/package version mismatches and writes `packaging/release-notes/prerelease-notes.md` without mutating tracked changelog files. When that file already exists, the generator includes it in the Claude prompt so later beta/RC notes reuse the reviewed text instead of starting over.
+- `changelog:prerelease-notes` also rejects tag/package version mismatches and writes `release/prerelease-notes.md` without mutating tracked changelog files. When that file already exists, the generator includes it in the Claude prompt so later beta/RC notes reuse the reviewed text instead of starting over.
 - From the second prerelease of a base version onward, the notes open with a `## Changes since <previous tag>` section above the cumulative `## Highlights`. The generator locates the newest preceding beta/RC tag for the same base version (semver order: all betas before all RCs), diffs `changes/*.md` between that tag and the working tree, and asks Claude to describe only the behavioral beta-to-beta differences — added fragments as new changes, modified fragments by their before/after difference (editorial-only edits are dropped), deleted fragments as removed/reverted changes. If no fragments changed (for example a packaging-only rebuild), the section states that explicitly without a Claude call. The delta section carries no separate contributor attribution; `## What's Changed` stays cumulative like `## Highlights`.
 - `changelog:check-prerelease-notes --version <version>` verifies the committed notes' `prerelease-version` marker matches the version being tagged; the prerelease workflow runs it and fails the release on stale notes.
-- `changelog:build` generates `CHANGELOG.md` + `packaging/release-notes/release-notes.md` (both polished by `claude -p`) and removes the released `changes/*.md` fragments. The CHANGELOG keeps internal notes inside a `<details><summary>Internal changes</summary>` collapse; the release notes drop them entirely.
-- `packaging/release-notes/release-notes.md` (and `packaging/release-notes/prerelease-notes.md`) include GitHub-style attribution after `## Highlights`: a `## What's Changed` list crediting each released fragment as `by @<author> in #<pr>`, plus a `## New Contributors` section for first-time authors. Attribution is resolved per fragment via `git log` (the commit that added the fragment) + `gh api .../commits/<sha>/pulls`, with one `gh` search per author for the first-contribution check. It needs `gh` installed and authenticated; if `gh` is unavailable or a lookup fails, the generator warns and emits notes without the attribution sections rather than failing. The CHANGELOG itself stays attribution-free.
+- `changelog:build` generates `CHANGELOG.md` + `release/release-notes.md` (both polished by `claude -p`) and removes the released `changes/*.md` fragments. The CHANGELOG keeps internal notes inside a `<details><summary>Internal changes</summary>` collapse; the release notes drop them entirely.
+- `release/release-notes.md` (and `release/prerelease-notes.md`) include GitHub-style attribution after `## Highlights`: a `## What's Changed` list crediting each released fragment as `by @<author> in #<pr>`, plus a `## New Contributors` section for first-time authors. Attribution is resolved per fragment via `git log` (the commit that added the fragment) + `gh api .../commits/<sha>/pulls`, with one `gh` search per author for the first-contribution check. It needs `gh` installed and authenticated; if `gh` is unavailable or a lookup fails, the generator warns and emits notes without the attribution sections rather than failing. The CHANGELOG itself stays attribution-free.
 - The release workflow no longer auto-runs `changelog:build`. If pending `changes/*.md` fragments are present on a tag-based run, CI exits with a clear `::error::` pointing at the local fix. Run `bun run changelog:build --version <version>` locally, commit the polished output, then tag.
 - Do not tag while `changes/*.md` fragments still exist.
-- Prerelease tags intentionally keep `changes/*.md` fragments in place so multiple prereleases can reuse the same cumulative pending notes until the final stable cut.
+- Prerelease tags intentionally keep `changes/*.md` fragments in place so multiple prereleases can reuse the same cumulative pending notes until the final stable cut. `make clean` preserves `release/prerelease-notes.md` while deleting generated build artifacts.
 - If you need to repair a published release body (for example, a prior version’s section was omitted), regenerate notes from `CHANGELOG.md` and re-edit the release with `gh release edit --notes-file`.
 - Prerelease tags are handled by `.github/workflows/prerelease.yml`, which always publishes a GitHub prerelease with all current release platforms and never runs the AUR sync job.
 - CI, stable release, and prerelease workflows call the shared `.github/workflows/quality-gate.yml`; update that reusable workflow when changing common test coverage. Its environment suite includes the Lua mpv plugin tests.

docs/workflow/verification.md

@@ -62,7 +62,7 @@ bun run docs:build
   then `bun run test:e2e` (see [Headless End-to-End Harness](#headless-end-to-end-harness))
 - Build/release scripts (`scripts/**`): `bun run test:scripts`
 - Packaging: build the platform package, then run `bun run test:package <resources-directory>`.
-  On headless Linux: `xvfb-run -a bun run test:package dist/release/linux-unpacked/resources`.
+  On headless Linux: `xvfb-run -a bun run test:package release/linux-unpacked/resources`.
   Content checks run inside the electron-builder afterPack hook. See the
   [release guide](../RELEASING.md#package-contents-checks) for the
   installed-app verification checklist.

e2e/harness/fake-anki.ts

@@ -37,12 +37,10 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
-// A recording AnkiConnect stand-in: one deck and one Lapis-shaped note type.
-// Added notes (with later `updateNoteFields` writes) are echoed back by `notesInfo`
-// so the app can resolve their fields; scenarios still assert on `requests`.
+// A recording AnkiConnect stand-in: an empty collection with one deck and one
+// Lapis-shaped note type. Scenarios assert on `requests`, not on stored notes.
 export async function startFakeAnki(): Promise<FakeAnki> {
   const requests: AnkiRequest[] = [];
-  const addedNotes = new Map<number, Record<string, unknown>>();
   let nextNoteId = 1000;
 
   const handle = (body: unknown): unknown => {
@@ -61,38 +59,10 @@ export async function startFakeAnki(): Promise<FakeAnki> {
         return [FAKE_ANKI_MODEL];
       case 'modelFieldNames':
         return MODEL_FIELDS;
-      case 'addNote': {
-        const noteId = nextNoteId++;
-        const note = isRecord(params.note) ? params.note : {};
-        addedNotes.set(noteId, isRecord(note.fields) ? { ...note.fields } : {});
-        return noteId;
-      }
-      case 'updateNoteFields': {
-        const note = isRecord(params.note) ? params.note : {};
-        const fields = typeof note.id === 'number' ? addedNotes.get(note.id) : undefined;
-        if (fields && isRecord(note.fields)) Object.assign(fields, note.fields);
-        return null;
-      }
-      case 'notesInfo': {
-        // Like AnkiConnect: one entry per requested id, `{}` for unknown notes.
-        const ids = Array.isArray(params.notes) ? params.notes : [];
-        return ids.map((id) => {
-          const fields = typeof id === 'number' ? addedNotes.get(id) : undefined;
-          if (!fields) return {};
-          return {
-            noteId: id,
-            modelName: FAKE_ANKI_MODEL,
-            tags: [],
-            fields: Object.fromEntries(
-              MODEL_FIELDS.map((name, order) => [
-                name,
-                { value: String(fields[name] ?? ''), order },
-              ]),
-            ),
-          };
-        });
-      }
+      case 'addNote':
+        return nextNoteId++;
       case 'findNotes':
+      case 'notesInfo':
         return [];
       case 'storeMediaFile':
         return params.filename ?? null;

e2e/playback.e2e.test.ts

@@ -91,14 +91,6 @@ async function showCue(cue: (typeof FIXTURE_CUES)[number]): Promise<RenderedToke
     });
 }
 
-// Card-kind flags are written before media, so wait for the update carrying audio.
-function findMediaUpdate(session: E2eSession) {
-  return session.anki.requests.find(
-    (request) =>
-      request.action === 'updateNoteFields' && JSON.stringify(request.params).includes('[sound:'),
-  );
-}
-
 function hasToken(tokens: RenderedToken[], surface: string, headword: string): boolean {
   return tokens.some((token) => token.surface === surface && token.headword === headword);
 }
@@ -134,10 +126,10 @@ test(
     session.anki.requests.length = 0;
 
     await session.runAppCommand('--mine-sentence');
-    const update = await waitUntil(() => findMediaUpdate(session), {
-      description: 'media fields to be written to the mined note',
-      timeoutMs: 30_000,
-    });
+    const update = await waitUntil(
+      () => session.anki.requests.find((request) => request.action === 'updateNoteFields'),
+      { description: 'media fields to be written to the mined note', timeoutMs: 30_000 },
+    );
 
     const added = session.anki.requests.filter((request) => request.action === 'addNote');
     assert.equal(added.length, 1);
@@ -164,38 +156,6 @@ test(
   },
 );
 
-test(
-  'mining a line retimed with sub-delay clips it where mpv plays it',
-  { timeout: TEST_TIMEOUT_MS },
-  async () => {
-    const { session, overlay } = await useSession();
-    const cue = FIXTURE_CUES[1];
-    const delay = 2;
-    await session.mpv.command('set_property', 'sub-delay', delay);
-    try {
-      // Past the cue's own end, so the line is only on screen because of the delay.
-      await session.mpv.command('seek', cue.end + delay / 2, 'absolute+exact');
-      await overlay.waitFor(
-        `document.getElementById('subtitleRoot').textContent === ${JSON.stringify(cue.text)}`,
-        { description: 'overlay to show the delayed line' },
-      );
-      session.anki.requests.length = 0;
-
-      await session.runAppCommand('--mine-sentence');
-      await waitUntil(() => findMediaUpdate(session), {
-        description: 'media fields to be written to the mined note',
-        timeoutMs: 30_000,
-      });
-
-      // MiscInfo stamps the clip start: the cue's start on the video clock.
-      const written = JSON.stringify(session.anki.requests);
-      assert.ok(written.includes(`(00:00:0${cue.start + delay})`), written);
-    } finally {
-      await session.mpv.command('set_property', 'sub-delay', 0);
-    }
-  },
-);
-
 test(
   'open subtitle sidebar lists the parsed cues and follows playback',
   { timeout: TEST_TIMEOUT_MS },
@@ -224,49 +184,6 @@ test(
   },
 );
 
-test(
-  'subtitle sidebar follows and seeks a sub-delay retimed track',
-  { timeout: TEST_TIMEOUT_MS },
-  async () => {
-    const { session, overlay } = await useSession();
-    const delay = 2;
-    await session.mpv.command('set_property', 'sub-delay', delay);
-    try {
-      // At 9s cue 2 starts on the file's clock, but mpv is still showing cue 1.
-      await session.mpv.command('seek', FIXTURE_CUES[2].start, 'absolute+exact');
-      await overlay.waitFor(
-        `document.getElementById('subtitleRoot').textContent === ${JSON.stringify(FIXTURE_CUES[1].text)}`,
-        { description: 'overlay to show the delayed line' },
-      );
-      await session.runAppCommand('--toggle-subtitle-sidebar');
-      await overlay.waitFor(
-        `document.querySelector('#subtitleSidebarList .subtitle-sidebar-item.active')?.dataset.index === '1'`,
-        { description: 'sidebar to highlight the delayed line' },
-      );
-
-      await overlay.evaluate(
-        `document.querySelector('#subtitleSidebarList .subtitle-sidebar-item[data-index="2"]').click()`,
-      );
-      const target = FIXTURE_CUES[2].start + delay;
-      await waitUntil(
-        async () => {
-          const time = Number(await session.mpv.command('get_property', 'time-pos'));
-          return time >= target && time < target + 0.5;
-        },
-        { description: `click to seek to cue 2 at ${target}s on the video clock` },
-      );
-
-      await session.runAppCommand('--toggle-subtitle-sidebar');
-      await overlay.waitFor(
-        `document.getElementById('subtitleSidebarModal').classList.contains('hidden')`,
-        { description: 'sidebar to close' },
-      );
-    } finally {
-      await session.mpv.command('set_property', 'sub-delay', 0);
-    }
-  },
-);
-
 // Runs last: it leaves the lookup popup open over the overlay.
 test(
   'holding Shift over a word opens the Yomitan popup with its dictionary entry',

launcher/mpv.test.ts

@@ -174,9 +174,8 @@ test('runAppCommandCaptureOutput strips ELECTRON_RUN_AS_NODE from app child env'
 
 test(
   'runAppCommandCaptureOutput transports Linux AppImage args through environment',
+  { skip: process.platform !== 'linux' },
   async () => {
-    // Bun's node:test shim ignores the `skip` option, so gate the platform here.
-    if (process.platform !== 'linux') return;
     await withTempCase(({ dir }) => {
       const appPath = writeFakeApp(
         dir,

package.json

@@ -2,7 +2,7 @@
   "name": "subminer",
   "productName": "SubMiner",
   "desktopName": "SubMiner.desktop",
-  "version": "0.21.1",
+  "version": "0.20.1",
   "description": "All-in-one sentence mining overlay with AnkiConnect and dictionary integration",
   "packageManager": "bun@1.3.5",
   "main": "dist/main-entry.js",
@@ -146,8 +146,7 @@
     "afterPack": "scripts/electron-builder-after-pack.cjs",
     "icon": "assets/SubMiner-square.png",
     "directories": {
-      "buildResources": "packaging/electron-builder",
-      "output": "dist/release"
+      "output": "release"
     },
     "publish": [
       {
@@ -179,8 +178,8 @@
       "category": "public.app-category.video",
       "icon": "assets/SubMiner-square.png",
       "hardenedRuntime": true,
-      "entitlements": "packaging/electron-builder/entitlements.mac.plist",
-      "entitlementsInherit": "packaging/electron-builder/entitlements.mac.plist",
+      "entitlements": "build/entitlements.mac.plist",
+      "entitlementsInherit": "build/entitlements.mac.plist",
       "extraResources": [
         {
           "from": "dist/scripts/get-mpv-window-macos",
@@ -212,7 +211,7 @@
       "oneClick": false,
       "perMachine": false,
       "allowToChangeInstallationDirectory": true,
-      "include": "packaging/electron-builder/installer.nsh"
+      "include": "build/installer.nsh"
     },
     "files": [
       "dist/**/*",
@@ -226,18 +225,17 @@
       "!**/{test,tests,__tests__,fixture,fixtures,__fixtures__}{,/**/*}",
       "!dist/launcher{,/**/*}",
       "!dist/scripts{,/**/*}",
-      "!dist/{yomitan,hachidori,release}{,/**/*}",
       "!dist/{renderer,settings,syncui}/fonts{,/**/*}",
       "!node_modules/koffi/{src,vendor,doc}{,/**/*}",
       "!node_modules/@libsql/linux-x64-musl{,/**/*}"
     ],
     "extraResources": [
       {
-        "from": "dist/yomitan",
+        "from": "build/yomitan",
         "to": "yomitan"
       },
       {
-        "from": "dist/hachidori",
+        "from": "build/hachidori",
         "to": "hachidori"
       },
       {
@@ -279,11 +277,6 @@
       }
     ]
   },
-  "prettier": {
-    "printWidth": 100,
-    "singleQuote": true,
-    "trailingComma": "all"
-  },
   "patchedDependencies": {
     "@discordjs/rest@2.6.1": "patches/@discordjs%2Frest@2.6.1.patch"
   }

packaging/release-notes/release-notes.md

@@ -1,32 +0,0 @@
-## Highlights
-### Changed
-- **Stats Session View**: The expanded session view in the stats dashboard has been redesigned. It shows stat tiles for pace, lines, known-word rate, lookups, and paused time, plus a reading density chart of known and unknown words with lookup and card-mined markers.
-
-### Fixed
-- **Subtitle Delay**: Retiming subtitles in mpv (z/x or sub-step) now carries through SubMiner. Mined card audio, images, and timestamps match the retimed line, and so do the subtitle sidebar, subtitle navigation, and replay.
-- **Subtitle Sidebar**: mpv keys and mouse buttons, such as volume keys and double-click fullscreen, work again while the sidebar is open.
-
-### Docs
-- **README**: Refreshed the anime screenshots using the current build.
-
-## What's Changed
-
-- fix(overlay): forward mpv input while subtitle sidebar is open by @ksyasuda in #300
-- fix(subtitles): follow mpv sub-delay in mining, sidebar, and navigation by @ksyasuda in #302
-- feat(stats): redesign expanded session view with density chart by @ksyasuda in #304
-
-## Installation
-
-See the README and docs/installation guide for full setup steps.
-
-## Assets
-
-- Linux: `SubMiner.AppImage`
-- macOS: `SubMiner-*.dmg` and `SubMiner-*.zip`
-- Windows: `SubMiner-*.exe` and `SubMiner-*-win.zip`
-- Optional extras: `subminer-assets.tar.gz`, the `subminer` launcher, and the Windows `subminer.cmd` launcher
-- Bun corresponding source: `bun-v1.3.5-source.tar.gz` and its `.sha256` file
-
-Both launcher downloads use Bun included with the SubMiner app. Download `subminer` on Linux or macOS and `subminer.cmd` on Windows.
-
-The app bundles an unmodified Bun 1.3.5 runtime. Bun is MIT licensed and statically links JavaScriptCore (LGPL 2.0) and TinyCC (LGPL 2.1). License texts and third-party notices ship inside the app under `resources/bun/licenses`, and the source archive above contains the matching Bun, WebKit, and dependency sources for relinking.

resources/bun/licenses/SOURCE.md

@@ -10,7 +10,7 @@ The SubMiner GitHub release containing this application also contains `bun-v1.3.
 - every external source repository registered by that Bun revision's CMake build, at its exact commit
 - Bun's dependency patches, build scripts, lockfiles, collected third-party license files, and instructions for rebuilding Bun against a modified JavaScriptCore
 
-The machine-readable inventory lives at `SOURCE-INVENTORY.json` inside the source archive and at `packaging/bun/bun-source-manifest.json` in SubMiner's source repository.
+The machine-readable inventory lives at `SOURCE-INVENTORY.json` inside the source archive and at `build/bun-source-manifest.json` in SubMiner's source repository.
 
 The archive vendors the source repositories linked through Bun's CMake build. It preserves Bun's package-manager lockfiles and lol-html's `Cargo.lock`, but it does not vendor npm packages, crates.io packages, compilers, SDKs, or other build tools. Rebuilding needs network access for those package-manager and toolchain inputs. The archive's rebuild README records the known tool versions and the remaining unpinned Rust nightly input.
 

resources/bun/licenses/THIRD-PARTY-NOTICES.md

@@ -1,6 +1,6 @@
 # Bun 1.3.5 third-party notices
 
-This file collects the license texts shipped by the external source repositories used by Bun 1.3.5 at the revisions in packaging/bun/bun-source-manifest.json. The corresponding-source release asset also preserves license notices embedded in individual Bun and WebKit source files. Bun’s own LICENSE.md lists additional embedded libraries and JavaScript polyfills whose source and per-file notices are included in that asset.
+This file collects the license texts shipped by the external source repositories used by Bun 1.3.5 at the revisions in build/bun-source-manifest.json. The corresponding-source release asset also preserves license notices embedded in individual Bun and WebKit source files. Bun’s own LICENSE.md lists additional embedded libraries and JavaScript polyfills whose source and per-file notices are included in that asset.
 
 ## BoringSSL
 

scripts/build-changelog.test.ts

@@ -203,7 +203,7 @@ test('writeChangelogArtifacts ignores README, groups fragments by type, writes r
       assert.match(changelog, /### Fixed\n- Polished: fixed entry\./);
       assert.match(changelog, /## v0\.4\.0 \(2026-03-01\)\n- Existing fix\n$/);
 
-      const releaseNotes = project.read('packaging/release-notes/release-notes.md');
+      const releaseNotes = project.read('release/release-notes.md');
       assert.match(releaseNotes, /## Highlights\n### Added\n- Polished: added entry\./);
       assert.match(releaseNotes, /### Fixed\n- Polished: fixed entry\./);
       assert.match(releaseNotes, /## Installation\n\nSee the README and docs\/installation guide/);
@@ -240,7 +240,7 @@ test('writeChangelogArtifacts skips changelog prepend when release section alrea
       assert.equal(project.exists('changes/001.md'), false);
       assert.equal(project.read('CHANGELOG.md'), existingChangelog);
       assert.match(
-        project.read('packaging/release-notes/release-notes.md'),
+        project.read('release/release-notes.md'),
         /## Highlights\n### Added\n- Existing release bullet\./,
       );
     },
@@ -268,7 +268,7 @@ test('writeStableReleaseArtifacts reuses the requested version and date for chan
       });
 
       assert.deepEqual(result.outputPaths, [project.at('CHANGELOG.md')]);
-      assert.equal(result.releaseNotesPath, project.at('packaging/release-notes/release-notes.md'));
+      assert.equal(result.releaseNotesPath, project.at('release/release-notes.md'));
       assert.equal(result.docsChangelogPath, project.at('docs-site/changelog.md'));
 
       assert.match(project.read('CHANGELOG.md'), /## v0\.4\.1 \(2026-03-07\)/);
@@ -471,7 +471,7 @@ test('writePrereleaseNotesForVersion writes cumulative beta notes without mutati
         deps: { runClaude: stub.runClaude, listPrereleaseTags: () => [] },
       });
 
-      assert.equal(outputPath, project.at('packaging/release-notes/prerelease-notes.md'));
+      assert.equal(outputPath, project.at('release/prerelease-notes.md'));
       assert.equal(
         project.read('CHANGELOG.md'),
         existingChangelog,
@@ -527,7 +527,7 @@ test('writePrereleaseNotesForVersion reuses existing prerelease notes when addin
     'prerelease-reuse-existing-notes',
     {
       'package.json': packageJson('0.11.3-beta.2'),
-      'packaging/release-notes/prerelease-notes.md': existingNotes,
+      'release/prerelease-notes.md': existingNotes,
       'changes/001.md': fragment('fixed', 'launcher', '- Fixed launcher prerelease packaging.'),
     },
     (project) => {
@@ -574,7 +574,7 @@ test('writePrereleaseNotesForVersion ignores unmarked prerelease notes from an o
     'prerelease-ignore-unmarked-old-notes',
     {
       'package.json': packageJson('0.17.0-beta.1'),
-      'packaging/release-notes/prerelease-notes.md': existingNotes,
+      'release/prerelease-notes.md': existingNotes,
       'changes/001.md': fragment(
         'changed',
         'overlay',
@@ -785,7 +785,7 @@ test('writeChangelogArtifacts filters internal fragments from the release-notes
         'release-notes mode drops internal fragments',
       );
 
-      const releaseNotes = project.read('packaging/release-notes/release-notes.md');
+      const releaseNotes = project.read('release/release-notes.md');
       assert.doesNotMatch(releaseNotes, /<details>/);
       assert.doesNotMatch(releaseNotes, /### Internal/);
       assert.match(
@@ -841,7 +841,7 @@ test('writeChangelogArtifacts appends contributor attribution and a new-contribu
         project.at('changes/002.md'),
       ]);
 
-      const releaseNotes = project.read('packaging/release-notes/release-notes.md');
+      const releaseNotes = project.read('release/release-notes.md');
       assert.match(releaseNotes, /## What's Changed\n\n/);
       assert.match(releaseNotes, /- feat\(overlay\): add a feature by @ksyasuda in #110\n/);
       assert.match(releaseNotes, /- fix\(jellyfin\): restart remote session by @bee-san in #112\n/);
@@ -904,10 +904,7 @@ test('writeChangelogArtifacts skips contributor attribution in GitHub Actions wi
         });
 
         assert.deepEqual(warnings, []);
-        assert.doesNotMatch(
-          project.read('packaging/release-notes/release-notes.md'),
-          /## What's Changed/,
-        );
+        assert.doesNotMatch(project.read('release/release-notes.md'), /## What's Changed/);
       } finally {
         console.warn = originalWarn;
         for (const key of envKeys) {
@@ -993,10 +990,7 @@ test('writeReleaseNotesForVersion preserves committed contributor attribution be
 
   await withProject(
     'release-notes-preserve-attribution',
-    {
-      'CHANGELOG.md': existingChangelog,
-      'packaging/release-notes/release-notes.md': committedReleaseNotes,
-    },
+    { 'CHANGELOG.md': existingChangelog, 'release/release-notes.md': committedReleaseNotes },
     (project) => {
       const outputPath = writeReleaseNotesForVersion({
         cwd: project.projectRoot,
@@ -1061,7 +1055,7 @@ test('writeChangelogArtifacts strips <details> blocks from release notes when re
         'no Claude calls should fire when the section already exists',
       );
 
-      const releaseNotes = project.read('packaging/release-notes/release-notes.md');
+      const releaseNotes = project.read('release/release-notes.md');
       assert.match(releaseNotes, /## Highlights\n### Added\n- Polished: previously committed\./);
       assert.doesNotMatch(releaseNotes, /<details>/);
       assert.doesNotMatch(releaseNotes, /### Internal/);
@@ -1243,7 +1237,7 @@ test('writePrereleaseNotesForVersion strips the stale delta section from the reu
     'prerelease-reuse-strips-delta',
     {
       'package.json': packageJson('0.12.0-beta.3'),
-      'packaging/release-notes/prerelease-notes.md': existingNotes,
+      'release/prerelease-notes.md': existingNotes,
       'changes/001.md': fragment('added', 'overlay', '- Added overlay coverage.'),
     },
     (project) => {
@@ -1277,7 +1271,7 @@ test('verifyPrereleaseNotesMatchVersion accepts matching notes and rejects stale
     (project) => {
       const verify = (version = '0.12.0-beta.2') =>
         verifyPrereleaseNotesMatchVersion({ cwd: project.projectRoot, version });
-      const notesPath = 'packaging/release-notes/prerelease-notes.md';
+      const notesPath = 'release/prerelease-notes.md';
 
       assert.throws(() => verify(), /Missing .*prerelease-notes\.md/);
 

scripts/build-changelog.ts

@@ -68,8 +68,8 @@ type PullRequestChangelogOptions = {
   changedLabels?: string[];
 };
 
-const RELEASE_NOTES_PATH = path.join('packaging', 'release-notes', 'release-notes.md');
-const PRERELEASE_NOTES_PATH = path.join('packaging', 'release-notes', 'prerelease-notes.md');
+const RELEASE_NOTES_PATH = path.join('release', 'release-notes.md');
+const PRERELEASE_NOTES_PATH = path.join('release', 'prerelease-notes.md');
 const CHANGELOG_HEADER = '# Changelog';
 const CHANGE_TYPES: FragmentType[] = ['added', 'changed', 'fixed', 'docs', 'internal'];
 const SKIP_CHANGELOG_LABEL = 'skip-changelog';
@@ -1144,7 +1144,7 @@ function isFragmentPath(candidate: string): boolean {
 function isIgnoredPullRequestPath(candidate: string): boolean {
   return (
     candidate === 'CHANGELOG.md' ||
-    candidate === 'packaging/release-notes/release-notes.md' ||
+    candidate === 'release/release-notes.md' ||
     candidate === 'AGENTS.md' ||
     candidate === 'README.md' ||
     candidate.startsWith('changes/') ||
@@ -1405,7 +1405,7 @@ export function verifyPrereleaseNotesMatchVersion(options?: ChangelogOptions): v
   const markerVersion = extractPrereleaseVersionMarker(readFileSync(prereleaseNotesPath, 'utf8'));
   if (markerVersion !== version) {
     throw new Error(
-      `packaging/release-notes/prerelease-notes.md was generated for ${markerVersion ?? 'an unknown version (missing or legacy prerelease-version marker)'} but this release is ${version}. Rerun 'bun run changelog:prerelease-notes --version ${version}' and commit the result.`,
+      `release/prerelease-notes.md was generated for ${markerVersion ?? 'an unknown version (missing or legacy prerelease-version marker)'} but this release is ${version}. Rerun 'bun run changelog:prerelease-notes --version ${version}' and commit the result.`,
     );
   }
 }

scripts/build-hachidori.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'node:url';
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const source = path.join(repoRoot, 'vendor', 'hachidori');
-const output = path.join(repoRoot, 'dist', 'hachidori');
+const output = path.join(repoRoot, 'build', 'hachidori');
 const provenance = JSON.parse(fs.readFileSync(path.join(source, 'SOURCE.json'), 'utf8'));
 
 // Upstream commits the engine binaries. Verify the pinned bytes before staging

scripts/build-hachidori.test.ts

@@ -19,7 +19,7 @@ test('Hachidori staging configures Electron without changing the fork source', a
     files.map((file) => readFileSync(source(file), 'utf8')),
     before,
   );
-  const staged = await import(new URL('../dist/hachidori/overlay-mode.js', import.meta.url).href);
+  const staged = await import(new URL('../build/hachidori/overlay-mode.js', import.meta.url).href);
   assert.equal(staged.OVERLAY_MODE, true);
   assert.equal(staged.HOST_CAPABILITIES.customJavaScript, false);
   const original = await import(source('overlay-mode.js').href);
@@ -28,13 +28,13 @@ test('Hachidori staging configures Electron without changing the fork source', a
   // SubMiner mines media from mpv, not the overlay viewport, so the lookup
   // highlight stays on for a first install.
   const stagedSetup = await import(
-    new URL('../dist/hachidori/setup-state.js', import.meta.url).href
+    new URL('../build/hachidori/setup-state.js', import.meta.url).href
   );
   assert.equal(stagedSetup.OVERLAY_MODE_OPTIONS.sourceHighlightEnabled, true);
   const originalSetup = await import(source('setup-state.js').href);
   assert.equal(originalSetup.OVERLAY_MODE_OPTIONS.sourceHighlightEnabled, false);
   const manifest = JSON.parse(
-    readFileSync(new URL('../dist/hachidori/manifest.json', import.meta.url), 'utf8'),
+    readFileSync(new URL('../build/hachidori/manifest.json', import.meta.url), 'utf8'),
   );
   const originalManifest = JSON.parse(readFileSync(source('manifest.json'), 'utf8'));
   assert.deepEqual(manifest, {

scripts/build-yomitan.mjs

@@ -10,7 +10,7 @@ const repoRoot = path.resolve(dirname, '..');
 const submoduleDir = path.join(repoRoot, 'vendor', 'subminer-yomitan');
 const submodulePackagePath = path.join(submoduleDir, 'package.json');
 const submodulePackageLockPath = path.join(submoduleDir, 'package-lock.json');
-const buildOutputDir = path.join(repoRoot, 'dist', 'yomitan');
+const buildOutputDir = path.join(repoRoot, 'build', 'yomitan');
 const stampPath = path.join(buildOutputDir, '.subminer-build.json');
 const zipPath = path.join(submoduleDir, 'builds', 'yomitan-chrome.zip');
 const bunCommand = process.versions.bun ? process.execPath : 'bun';

scripts/check-hachidori-parser.cjs

@@ -48,7 +48,7 @@ app
   .then(async () => {
     const targetSession = session.fromPartition('persist:hachidori-check');
     const extension = await targetSession.extensions.loadExtension(
-      path.join(root, 'dist/hachidori'),
+      path.join(root, 'build/hachidori'),
       { allowFileAccess: true },
     );
     // Keep a host window alive while the dictionary importer opens/closes its

scripts/package-audit.test.ts

@@ -18,7 +18,7 @@ test('platform packaging preserves the runtime allowlist after builder normalize
       '/tmp/subminer-filter-output',
       {
         defaultSrc: root,
-        globalOutDir: path.join(root, 'dist', 'release'),
+        globalOutDir: path.join(root, 'release'),
         customBuildOptions: { files: config.build[platform].files },
         macroExpander: (value) => value.replaceAll('${arch}', 'x64'),
       },
@@ -51,9 +51,6 @@ test('platform packaging preserves the runtime allowlist after builder normalize
       'stats/dist/nested/fixtures/data.json',
       'vendor/texthooker-ui/docs/nested/component.tsx',
       'dist/launcher/subminer',
-      'dist/yomitan/manifest.json',
-      'dist/hachidori/manifest.json',
-      'dist/release/SubMiner-1.0.0.AppImage',
       'dist/settings/fonts/MPLUS1[wght].ttf',
       'vendor/subminer-yomitan/ext/manifest.json',
     ]) {

scripts/package-bun-source.mjs

@@ -10,20 +10,14 @@ import { Readable } from 'node:stream';
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(scriptDir, '..');
 
-export const DEFAULT_MANIFEST_PATH = path.join(
-  repoRoot,
-  'packaging',
-  'bun',
-  'bun-source-manifest.json',
-);
+export const DEFAULT_MANIFEST_PATH = path.join(repoRoot, 'build', 'bun-source-manifest.json');
 export const DEFAULT_RUNTIME_MANIFEST_PATH = path.join(
   repoRoot,
-  'packaging',
-  'bun',
+  'build',
   'bun-runtime-manifest.json',
 );
 export const DEFAULT_PACKAGE_JSON_PATH = path.join(repoRoot, 'package.json');
-export const DEFAULT_OUTPUT_DIR = path.join(repoRoot, 'dist', 'release');
+export const DEFAULT_OUTPUT_DIR = path.join(repoRoot, 'release');
 export const DEFAULT_CACHE_DIR = path.join(repoRoot, '.tmp', 'bun-corresponding-source');
 
 function isRecord(value) {

scripts/package-bun-source.test.ts

@@ -4,9 +4,6 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import {
-  DEFAULT_MANIFEST_PATH,
-  DEFAULT_PACKAGE_JSON_PATH,
-  DEFAULT_RUNTIME_MANIFEST_PATH,
   downloadArchive,
   parseRegisteredRepositories,
   parseSourceManifest,
@@ -70,26 +67,10 @@ describe('Bun corresponding-source manifest', () => {
     });
   });
 
-  test('default manifest paths resolve to aligned checked-in manifests', async () => {
-    const [manifestText, runtimeManifestText, packageJsonText] = await Promise.all([
-      fs.readFile(DEFAULT_MANIFEST_PATH, 'utf8'),
-      fs.readFile(DEFAULT_RUNTIME_MANIFEST_PATH, 'utf8'),
-      fs.readFile(DEFAULT_PACKAGE_JSON_PATH, 'utf8'),
-    ]);
-
-    expect(() =>
-      validateRuntimeAlignment(
-        parseSourceManifest(JSON.parse(manifestText)),
-        JSON.parse(packageJsonText),
-        JSON.parse(runtimeManifestText),
-      ),
-    ).not.toThrow();
-  });
-
   test('rejects stale runtime or package-manager pins', async () => {
     const manifest = parseSourceManifest(
       JSON.parse(
-        await fs.readFile(path.join(projectRoot, 'packaging/bun/bun-source-manifest.json'), 'utf8'),
+        await fs.readFile(path.join(projectRoot, 'build/bun-source-manifest.json'), 'utf8'),
       ),
     );
     const runtimeManifest = {
@@ -119,7 +100,7 @@ describe('Bun corresponding-source manifest', () => {
   test('rejects drift in CMake dependency and WebKit pins', async () => {
     const manifest = parseSourceManifest(
       JSON.parse(
-        await fs.readFile(path.join(projectRoot, 'packaging/bun/bun-source-manifest.json'), 'utf8'),
+        await fs.readFile(path.join(projectRoot, 'build/bun-source-manifest.json'), 'utf8'),
       ),
     );
     const registrations = manifest.sources

scripts/patch-yomitan.sh

@@ -6,7 +6,7 @@ cat <<'EOF'
 patch-yomitan.sh is retired.
 
 SubMiner now uses the forked source submodule at vendor/subminer-yomitan and builds the
-Chromium extension artifact into dist/yomitan.
+Chromium extension artifact into build/yomitan.
 
 Use:
   git submodule update --init --recursive

scripts/prettier-scope.sh

@@ -9,9 +9,9 @@ paths=(
   "tsconfig.json"
   "tsconfig.renderer.json"
   "tsconfig.typecheck.json"
+  ".prettierrc.json"
   ".github"
-  "packaging/bun/bun-runtime-manifest.json"
-  "packaging/bun/bun-source-manifest.json"
+  "build"
   "e2e"
   "launcher"
   "scripts"

scripts/stage-bun-runtime.mjs

@@ -14,14 +14,9 @@ const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(scriptDir, '..');
 
 export const DEFAULT_PACKAGE_JSON_PATH = path.join(repoRoot, 'package.json');
-export const DEFAULT_MANIFEST_PATH = path.join(
-  repoRoot,
-  'packaging',
-  'bun',
-  'bun-runtime-manifest.json',
-);
+export const DEFAULT_MANIFEST_PATH = path.join(repoRoot, 'build', 'bun-runtime-manifest.json');
 export const DEFAULT_CACHE_DIR = path.join(repoRoot, '.tmp', 'bun-runtime');
-export const DEFAULT_LICENSES_SOURCE_DIR = path.join(repoRoot, 'packaging', 'bun', 'licenses');
+export const DEFAULT_LICENSES_SOURCE_DIR = path.join(repoRoot, 'resources', 'bun', 'licenses');
 export const STAGED_METADATA_FILE = 'metadata.json';
 export const REQUIRED_LICENSE_FILES = [
   'Bun-LICENSE.md',

scripts/stage-bun-runtime.test.ts

@@ -35,7 +35,7 @@ function runtimeConfig() {
       'win32-x64': { file: 'bun-windows-x64-baseline.zip', sha256: '5'.repeat(64) },
     },
     licenseInventoryStatus: 'complete-for-bun-1.3.5-declared-linked-libraries',
-    sourceManifest: 'packaging/bun/bun-source-manifest.json',
+    sourceManifest: 'build/bun-source-manifest.json',
     correspondingSourceAsset: 'bun-v1.3.5-source.tar.gz',
   };
 }
@@ -96,7 +96,7 @@ test('manifest version must match the exact packageManager Bun pin', () => {
           releaseTagCommit: 'fa5a5bbe556a4bda5bde77b4013aa6c3bb4ec9ab',
           artifacts: {},
           licenseInventoryStatus: 'partial',
-          sourceManifest: 'packaging/bun/bun-source-manifest.json',
+          sourceManifest: 'build/bun-source-manifest.json',
           correspondingSourceAsset: 'bun-v1.3.5-source.tar.gz',
         },
         '1.3.5',

src/anki-integration.ts

@@ -45,7 +45,6 @@ import {
 } from './anki-field-config';
 import { createLogger } from './logger';
 import { captureLiveSubtitleMiningContext } from './core/services/mining';
-import { shiftSubtitleRangeToVideoClock } from './core/services/subtitle-clock';
 import {
   createUiFeedbackState,
   beginUpdateProgress,
@@ -1030,10 +1029,10 @@ export class AnkiIntegration {
       Number.isFinite(this.mpvClient.currentSubEnd) &&
       this.mpvClient.currentSubEnd > this.mpvClient.currentSubStart
     ) {
-      return shiftSubtitleRangeToVideoClock(
-        { startTime: this.mpvClient.currentSubStart, endTime: this.mpvClient.currentSubEnd },
-        this.mpvClient.currentSubDelay,
-      );
+      return {
+        startTime: this.mpvClient.currentSubStart,
+        endTime: this.mpvClient.currentSubEnd,
+      };
     }
 
     const currentTime = this.mpvClient.currentTimePos || 0;
@@ -1673,7 +1672,7 @@ export class AnkiIntegration {
           if (this.config.fields?.miscInfo) {
             result.miscInfoValue = this.formatMiscInfoPattern(
               audioFilename,
-              this.mpvClient.currentSubStart + this.mpvClient.currentSubDelay,
+              this.mpvClient.currentSubStart,
             );
           }
         }
@@ -1696,7 +1695,7 @@ export class AnkiIntegration {
           if (this.config.fields?.miscInfo && !result.miscInfoValue) {
             result.miscInfoValue = this.formatMiscInfoPattern(
               imageFilename,
-              this.mpvClient.currentSubStart + this.mpvClient.currentSubDelay,
+              this.mpvClient.currentSubStart,
             );
           }
         }

src/anki-integration/card-creation.ts

@@ -10,7 +10,6 @@ import {
   type MediaTimingReviewRequest,
   type WordCardKind,
 } from '../types/anki';
-import { shiftSubtitleRangeToVideoClock } from '../core/services/subtitle-clock';
 import { createLogger } from '../logger';
 import type { MediaInput } from '../media-input';
 import { SubtitleTimingTracker } from '../subtitle-timing-tracker';
@@ -429,12 +428,10 @@ export class CardCreationService {
         return;
       }
 
-      let { startTime, endTime } = shiftSubtitleRangeToVideoClock(
-        { startTime: mpvClient.currentSubStart, endTime: mpvClient.currentSubEnd },
-        mpvClient.currentSubDelay,
-      );
+      let startTime = mpvClient.currentSubStart;
+      let endTime = mpvClient.currentSubEnd;
 
-      if (mpvClient.currentSubStart === undefined || mpvClient.currentSubEnd === undefined) {
+      if (startTime === undefined || endTime === undefined) {
         const currentTime = mpvClient.currentTimePos || 0;
         const fallback = this.deps.getFallbackDurationSeconds() / 2;
         startTime = currentTime - fallback;

src/config/definitions/options-integrations.ts

@@ -554,7 +554,7 @@ export function buildIntegrationConfigOptionRegistry(
       kind: 'string',
       defaultValue: defaultConfig.mpv.executablePath,
       description:
-        'Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.',
+        'Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.',
     },
     {
       path: 'mpv.launchMode',

src/config/definitions/template-sections.ts

@@ -223,7 +223,7 @@ const INTEGRATION_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
       'autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.',
       'Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.',
       'Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.',
-      'Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.',
+      'Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.',
     ],
     key: 'mpv',
   },

src/core/services/hachidori-extension.test.ts

@@ -11,9 +11,9 @@ test('Hachidori resolves development and packaged artifacts without falling back
   assert.equal(
     resolveHachidoriExtensionPath({
       ...options,
-      exists: (p) => p === '/app/dist/hachidori/manifest.json',
+      exists: (p) => p === '/app/build/hachidori/manifest.json',
     }),
-    '/app/dist/hachidori',
+    '/app/build/hachidori',
   );
   assert.equal(
     resolveHachidoriExtensionPath({

src/core/services/hachidori-extension.ts

@@ -15,7 +15,7 @@ export function resolveHachidoriExtensionPath(options: {
   exists?: (candidate: string) => boolean;
 }): string {
   const candidates = [
-    path.resolve(options.moduleDir, '../../../dist/hachidori'),
+    path.resolve(options.moduleDir, '../../../build/hachidori'),
     path.join(options.resourcesPath, 'hachidori'),
   ];
   const found = candidates.find((candidate) =>

src/core/services/index.ts

@@ -55,7 +55,6 @@ export {
   subtitleCueListSeekTime,
   subtitleCueSeekTime,
 } from './subtitle-cue-navigation';
-export { shiftSubtitleRangeToVideoClock, toSubtitleClock, toVideoClock } from './subtitle-clock';
 export { createFrequencyDictionaryLookup } from './frequency-dictionary';
 export { createJlptVocabularyLookup } from './jlpt-vocab';
 export {

src/core/services/ipc.test.ts

@@ -89,7 +89,6 @@ function createSubtitleSidebarSnapshotFixture(): SubtitleSidebarSnapshot {
     cuesRevision: 1,
     cues: [],
     currentTimeSec: null,
-    subDelay: 0,
     currentSubtitle: { text: '', startTime: null, endTime: null },
     config: {
       enabled: false,

src/core/services/mining.test.ts

@@ -77,7 +77,6 @@ test('mineSentenceCard handles missing integration and disconnected mpv', async
         currentSubText: 'line',
         currentSubStart: 1,
         currentSubEnd: 2,
-        currentSubDelay: 0,
       },
       showMpvOsd: (text) => osd.push(text),
     }),
@@ -110,7 +109,6 @@ test('mineSentenceCard creates sentence card from mpv subtitle state', async ()
       currentSubText: 'subtitle line',
       currentSubStart: 10,
       currentSubEnd: 12,
-      currentSubDelay: 0,
       currentSecondarySubText: 'secondary line',
     },
     showMpvOsd: () => {},
@@ -150,7 +148,6 @@ test('mineSentenceCard prefers a canonical primary subtitle snapshot', async ()
       currentSubText: '今今今手手手',
       currentSubStart: 11.4,
       currentSubEnd: 11.8,
-      currentSubDelay: 0,
       currentSecondarySubText: 'English subtitle',
     },
     primarySubtitle: {
@@ -190,7 +187,6 @@ test('mineSentenceCard uses normalized secondary subtitle state instead of raw m
       currentSubText: '日本語字幕',
       currentSubStart: 10,
       currentSubEnd: 12,
-      currentSubDelay: 0,
       currentSecondarySubText: 'Your\nmosaic',
       requestProperty: async () => {
         requestedRawSecondaryText = true;
@@ -222,7 +218,6 @@ test('mineSentenceCard omits normalized secondary text that matches the primary
       currentSubText: '日本語字幕',
       currentSubStart: 10,
       currentSubEnd: 12,
-      currentSubDelay: 0,
       currentSecondarySubText: '日本語字幕',
     },
     showMpvOsd: () => {},
@@ -401,7 +396,7 @@ test('handleMineSentenceDigit joins per-entry secondary subtitles when available
 
 test('captureLiveSubtitleMiningContext snapshots the current line and timings', () => {
   const context = captureLiveSubtitleMiningContext(
-    { currentSubText: ' 食べる ', currentSubStart: 12.5, currentSubEnd: 15.25, currentSubDelay: 0 },
+    { currentSubText: ' 食べる ', currentSubStart: 12.5, currentSubEnd: 15.25 },
     () => 1234,
   );
 
@@ -414,16 +409,6 @@ test('captureLiveSubtitleMiningContext snapshots the current line and timings',
   });
 });
 
-test('captureLiveSubtitleMiningContext moves sub-delay retimed lines onto the video clock', () => {
-  const context = captureLiveSubtitleMiningContext(
-    { currentSubText: '食べる', currentSubStart: 5, currentSubEnd: 8, currentSubDelay: -1.5 },
-    () => 1234,
-  );
-
-  assert.equal(context?.startTime, 3.5);
-  assert.equal(context?.endTime, 6.5);
-});
-
 test('captureLiveSubtitleMiningContext rejects missing client, empty text and bad timings', () => {
   assert.equal(captureLiveSubtitleMiningContext(null), null);
   assert.equal(
@@ -431,7 +416,6 @@ test('captureLiveSubtitleMiningContext rejects missing client, empty text and ba
       currentSubText: '  ',
       currentSubStart: 1,
       currentSubEnd: 2,
-      currentSubDelay: 0,
     }),
     null,
   );
@@ -440,7 +424,6 @@ test('captureLiveSubtitleMiningContext rejects missing client, empty text and ba
       currentSubText: 'line',
       currentSubStart: 5,
       currentSubEnd: 5,
-      currentSubDelay: 0,
     }),
     null,
   );
@@ -449,7 +432,6 @@ test('captureLiveSubtitleMiningContext rejects missing client, empty text and ba
       currentSubText: 'line',
       currentSubStart: NaN,
       currentSubEnd: 2,
-      currentSubDelay: 0,
     }),
     null,
   );

src/core/services/mining.ts

@@ -1,6 +1,5 @@
 import type { SubtitleTimingBlock } from '../../subtitle-timing-tracker';
 import type { SubtitleMiningContext } from '../../types/subtitle';
-import { shiftSubtitleRangeToVideoClock } from './subtitle-clock';
 
 interface SubtitleTimingTrackerLike {
   getRecentBlocks: (count: number) => string[];
@@ -26,7 +25,6 @@ interface MpvClientLike {
   currentSubText: string;
   currentSubStart: number;
   currentSubEnd: number;
-  currentSubDelay: number;
   currentSecondarySubText?: string;
   requestProperty?: (name: string) => Promise<unknown>;
 }
@@ -64,10 +62,7 @@ export function handleMultiCopyDigit(
  * line is on screen by then; callers capture here at mining time instead.
  */
 export function captureLiveSubtitleMiningContext(
-  client: Pick<
-    MpvClientLike,
-    'currentSubText' | 'currentSubStart' | 'currentSubEnd' | 'currentSubDelay'
-  > | null,
+  client: Pick<MpvClientLike, 'currentSubText' | 'currentSubStart' | 'currentSubEnd'> | null,
   now: () => number = Date.now,
 ): SubtitleMiningContext | null {
   if (!client) {
@@ -78,10 +73,7 @@ export function captureLiveSubtitleMiningContext(
   if (!text || !Number.isFinite(startTime) || !Number.isFinite(endTime) || endTime <= startTime) {
     return null;
   }
-  return shiftSubtitleRangeToVideoClock<SubtitleMiningContext>(
-    { source: 'overlay', text, startTime, endTime, capturedAtMs: now() },
-    client.currentSubDelay,
-  );
+  return { source: 'overlay', text, startTime, endTime, capturedAtMs: now() };
 }
 
 export function copyCurrentSubtitle(deps: {
@@ -175,7 +167,6 @@ export async function markLastCardAsAudioCard(deps: {
 export async function mineSentenceCard(deps: {
   ankiIntegration: AnkiIntegrationLike | null;
   mpvClient: MpvClientLike | null;
-  /** Already on the video clock, like every `SubtitleMiningContext`. */
   primarySubtitle?: Pick<SubtitleMiningContext, 'text' | 'startTime' | 'endTime'>;
   showMpvOsd: (text: string) => void;
 }): Promise<boolean> {
@@ -194,16 +185,10 @@ export async function mineSentenceCard(deps: {
   }
 
   const secondarySubText = getCurrentSecondarySubTextForSentenceCard(mpvClient, primaryText);
-  const range =
-    deps.primarySubtitle ??
-    shiftSubtitleRangeToVideoClock(
-      { startTime: mpvClient.currentSubStart, endTime: mpvClient.currentSubEnd },
-      mpvClient.currentSubDelay,
-    );
   return await anki.createSentenceCard(
     primaryText,
-    range.startTime,
-    range.endTime,
+    deps.primarySubtitle?.startTime ?? mpvClient.currentSubStart,
+    deps.primarySubtitle?.endTime ?? mpvClient.currentSubEnd,
     secondarySubText,
   );
 }

src/core/services/mpv-properties.ts

@@ -38,7 +38,6 @@ const MPV_SUBTITLE_PROPERTY_OBSERVATIONS: string[] = [
   'path',
   'sub-start',
   'sub-end',
-  'sub-delay',
   'time-pos',
   'secondary-sub-text',
   'aid',

src/core/services/mpv-protocol.test.ts

@@ -73,8 +73,6 @@ function createDeps(overrides: Partial<MpvProtocolHandleMessageDeps> = {}): {
       getCurrentSubStart: () => 0,
       setCurrentSubEnd: () => {},
       getCurrentSubEnd: () => 0,
-      setCurrentSubDelay: () => {},
-      getCurrentSubDelay: () => 0,
       emitMediaPathChange: (payload) => {
         state.mediaPath = payload.path;
       },
@@ -133,22 +131,6 @@ test('dispatchMpvProtocolMessage emits subtitle text on property change', async
   assert.deepEqual(state.events, [{ text: '字幕', isOverlayVisible: false }]);
 });
 
-test('dispatchMpvProtocolMessage tracks sub-delay retiming', async () => {
-  const delays: number[] = [];
-  const { deps } = createDeps({ setCurrentSubDelay: (value) => delays.push(value) });
-
-  await dispatchMpvProtocolMessage(
-    { event: 'property-change', name: 'sub-delay', data: 1.5 },
-    deps,
-  );
-  await dispatchMpvProtocolMessage(
-    { event: 'property-change', name: 'sub-delay', data: null },
-    deps,
-  );
-
-  assert.deepEqual(delays, [1.5, 0]);
-});
-
 test('dispatchMpvProtocolMessage widens halfwidth katakana in subtitle text', async () => {
   const { deps, state } = createDeps();
 
@@ -397,29 +379,6 @@ test('dispatchMpvProtocolMessage pauses on sub-end when pendingPauseAtSubEnd is
   });
 });
 
-test('dispatchMpvProtocolMessage pauses at the sub-delay retimed sub-end', async () => {
-  let pauseAtTime: number | null = null;
-  let subDelay = 1.5;
-  const { deps } = createDeps({
-    getPendingPauseAtSubEnd: () => true,
-    getCurrentSubDelay: () => subDelay,
-    setCurrentSubDelay: (next) => {
-      subDelay = next;
-    },
-    getPauseAtTime: () => pauseAtTime,
-    setPauseAtTime: (next) => {
-      pauseAtTime = next;
-    },
-  });
-
-  await dispatchMpvProtocolMessage({ event: 'property-change', name: 'sub-end', data: 42 }, deps);
-  assert.equal(pauseAtTime, 43.5);
-
-  // Retiming before the replay reaches its end moves the pause with the line.
-  await dispatchMpvProtocolMessage({ event: 'property-change', name: 'sub-delay', data: 2 }, deps);
-  assert.equal(pauseAtTime, 44);
-});
-
 test('dispatchMpvProtocolMessage updates current time before emitting time-pos change', async () => {
   const calls: string[] = [];
   let currentTimePos = 0;

src/core/services/mpv-protocol.ts

@@ -1,7 +1,6 @@
 import { MpvSubtitleRenderMetrics } from '../../types';
 import { sanitizeMediaTitle } from '../../shared/media-identity';
 import { widenHalfwidthKana } from '../utils/halfwidth-kana';
-import { toVideoClock } from './subtitle-clock';
 
 export type MpvMessage = {
   event?: string;
@@ -65,8 +64,6 @@ export interface MpvProtocolHandleMessageDeps {
   getCurrentSubStart: () => number;
   setCurrentSubEnd: (value: number) => void;
   getCurrentSubEnd: () => number;
-  setCurrentSubDelay: (value: number) => void;
-  getCurrentSubDelay: () => number;
   emitMediaPathChange: (payload: { path: string }) => void;
   emitMediaTitleChange: (payload: { title: string | null }) => void;
   emitTimePosChange: (payload: { time: number }) => void;
@@ -266,8 +263,7 @@ export async function dispatchMpvProtocolMessage(
       const subEnd = (msg.data as number) || 0;
       deps.setCurrentSubEnd(subEnd);
       if (deps.getPendingPauseAtSubEnd() && subEnd > 0) {
-        // `sub-end` is on the subtitle clock; the pause check compares it with `time-pos`.
-        deps.setPauseAtTime(toVideoClock(subEnd, deps.getCurrentSubDelay()));
+        deps.setPauseAtTime(subEnd);
         deps.setPendingPauseAtSubEnd(false);
         deps.sendCommand({ command: ['set_property', 'pause', false] });
       }
@@ -276,16 +272,6 @@ export async function dispatchMpvProtocolMessage(
         start: deps.getCurrentSubStart(),
         end: deps.getCurrentSubEnd(),
       });
-    } else if (msg.name === 'sub-delay') {
-      const parsed = typeof msg.data === 'number' ? msg.data : Number(msg.data);
-      const delay = Number.isFinite(parsed) ? parsed : 0;
-      // A scheduled replay pause sits at the line's end on the video clock; retiming
-      // mid-replay moves that end, so the pause moves with it.
-      const pauseAtTime = deps.getPauseAtTime();
-      if (pauseAtTime !== null) {
-        deps.setPauseAtTime(pauseAtTime + delay - deps.getCurrentSubDelay());
-      }
-      deps.setCurrentSubDelay(delay);
     } else if (msg.name === 'secondary-sub-text') {
       const nextSubText = (msg.data as string) || '';
       deps.setCurrentSecondarySubText(nextSubText);

src/core/services/mpv.ts

@@ -160,8 +160,6 @@ export class MpvIpcClient implements MpvClient {
   public currentTimePos = 0;
   public currentSubStart = 0;
   public currentSubEnd = 0;
-  /** mpv `sub-delay`: seconds each primary line plays after its `sub-start`/`sub-end`. */
-  public currentSubDelay = 0;
   public currentSubText = '';
   public currentSecondarySubText = '';
   public currentAudioStreamIndex: number | null = null;
@@ -461,10 +459,6 @@ export class MpvIpcClient implements MpvClient {
         this.currentSubEnd = value;
       },
       getCurrentSubEnd: () => this.currentSubEnd,
-      setCurrentSubDelay: (value: number) => {
-        this.currentSubDelay = value;
-      },
-      getCurrentSubDelay: () => this.currentSubDelay,
       emitMediaPathChange: (payload) => {
         this.emit('media-path-change', payload);
       },

src/core/services/subtitle-clock.ts

@@ -1,32 +0,0 @@
-/**
- * mpv's `sub-start`/`sub-end` and parsed cues carry the subtitle file's own timestamps
- * (the subtitle clock), but mpv plays each line `sub-delay` seconds later (z/x retiming,
- * `sub-step`). Playback position, seeks, and media cuts are on the video clock, so any
- * value crossing between the two converts here.
- */
-
-function finiteDelay(subDelay: number): number {
-  return Number.isFinite(subDelay) ? subDelay : 0;
-}
-
-/** Playback position (`time-pos`) on the subtitle clock, comparable with cue times. */
-export function toSubtitleClock(videoTimeSec: number, subDelay: number): number {
-  return videoTimeSec - finiteDelay(subDelay);
-}
-
-/** Subtitle-clock seconds on the video clock, for seeks. */
-export function toVideoClock(subtitleTimeSec: number, subDelay: number): number {
-  return subtitleTimeSec + finiteDelay(subDelay);
-}
-
-/** A subtitle-clock range on the video clock, for mining and media generation. */
-export function shiftSubtitleRangeToVideoClock<T extends { startTime: number; endTime: number }>(
-  range: T,
-  subDelay: number,
-): T {
-  const delay = finiteDelay(subDelay);
-  if (delay === 0) {
-    return range;
-  }
-  return { ...range, startTime: range.startTime + delay, endTime: range.endTime + delay };
-}

src/core/services/subtitle-cue-navigation.test.ts

@@ -26,7 +26,7 @@ test('next subtitle navigation skips generated ASS events and seeks to the next
     },
   ];
 
-  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.2, 0), [
+  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.2), [
     'seek',
     13.08,
     'absolute+exact',
@@ -41,7 +41,7 @@ test('next subtitle navigation treats simultaneous sanitized cues as one line bo
     { startTime: 13.02, endTime: 16, text: 'Next English' },
   ];
 
-  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.1, 0), [
+  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.1), [
     'seek',
     13.08,
     'absolute+exact',
@@ -55,7 +55,7 @@ test('next subtitle navigation advances past the latest overlapping lyric', () =
     { startTime: 16, endTime: 19, text: 'next lyric' },
   ];
 
-  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 13.2, 0), [
+  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 13.2), [
     'seek',
     16.08,
     'absolute+exact',
@@ -68,7 +68,7 @@ test('previous subtitle navigation leaves the current cue and seeks to the prior
     { startTime: 13, endTime: 16, text: 'current line' },
   ];
 
-  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', -1], cues, 14.5, 0), [
+  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', -1], cues, 14.5), [
     'seek',
     10.08,
     'absolute+exact',
@@ -78,22 +78,8 @@ test('previous subtitle navigation leaves the current cue and seeks to the prior
 test('subtitle navigation falls back when no sanitized destination exists', () => {
   const cues = [{ startTime: 10, endTime: 13, text: 'only line' }];
 
-  assert.equal(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.2, 0), null);
-  assert.equal(resolveSanitizedSubtitleSeekCommand(['seek', 5], cues, 10.2, 0), null);
-});
-
-test('subtitle cue navigation finds and seeks cues on the sub-delay retimed timeline', () => {
-  const cues = [
-    { startTime: 10, endTime: 13, text: 'one' },
-    { startTime: 13, endTime: 16, text: 'two' },
-  ];
-
-  // At 14.5 with a 2s delay, mpv is showing "one" (12-15 on the video clock).
-  assert.deepEqual(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 14.5, 2), [
-    'seek',
-    15.08,
-    'absolute+exact',
-  ]);
+  assert.equal(resolveSanitizedSubtitleSeekCommand(['sub-seek', 1], cues, 10.2), null);
+  assert.equal(resolveSanitizedSubtitleSeekCommand(['seek', 5], cues, 10.2), null);
 });
 
 test('sidebar cue seeks share the boundary-safe sanitized cue timestamp', () => {

src/core/services/subtitle-cue-navigation.ts

@@ -1,4 +1,3 @@
-import { toSubtitleClock, toVideoClock } from './subtitle-clock';
 import type { SubtitleCue } from './subtitle-cue-parser';
 
 const CUE_START_GROUP_TOLERANCE_SECONDS = 0.05;
@@ -81,10 +80,8 @@ export function subtitleCueListSeekTime(
 export function resolveSanitizedSubtitleSeekCommand(
   command: readonly (string | number)[],
   cues: readonly SubtitleCue[],
-  videoTimeSec: number,
-  subDelay: number,
+  currentTimeSec: number,
 ): (string | number)[] | null {
-  const currentTimeSec = toSubtitleClock(videoTimeSec, subDelay);
   if (
     command.length < 2 ||
     command[0] !== 'sub-seek' ||
@@ -127,5 +124,5 @@ export function resolveSanitizedSubtitleSeekCommand(
   if (!destination) {
     return null;
   }
-  return ['seek', toVideoClock(subtitleCueSeekTime(destination.cue), subDelay), 'absolute+exact'];
+  return ['seek', subtitleCueSeekTime(destination.cue), 'absolute+exact'];
 }

src/core/services/yomitan-extension-paths.test.ts

@@ -20,7 +20,7 @@ test('getYomitanExtensionSearchPaths prioritizes generated build output before p
   });
 
   assert.deepEqual(searchPaths, [
-    path.join(repoRoot, 'dist', 'yomitan'),
+    path.join(repoRoot, 'build', 'yomitan'),
     path.join(resourcesPath, 'yomitan'),
     '/usr/share/SubMiner/yomitan',
     path.join(userDataPath, 'yomitan'),
@@ -29,19 +29,19 @@ test('getYomitanExtensionSearchPaths prioritizes generated build output before p
 
 test('resolveExistingYomitanExtensionPath returns first manifest-backed candidate', () => {
   const existing = new Set<string>([
-    path.join('/repo', 'dist', 'yomitan', 'manifest.json'),
+    path.join('/repo', 'build', 'yomitan', 'manifest.json'),
     path.join('/repo', 'vendor', 'subminer-yomitan', 'ext', 'manifest.json'),
   ]);
 
   const resolved = resolveExistingYomitanExtensionPath(
     [
-      path.join('/repo', 'dist', 'yomitan'),
+      path.join('/repo', 'build', 'yomitan'),
       path.join('/repo', 'vendor', 'subminer-yomitan', 'ext'),
     ],
     (candidate) => existing.has(candidate),
   );
 
-  assert.equal(resolved, path.join('/repo', 'dist', 'yomitan'));
+  assert.equal(resolved, path.join('/repo', 'build', 'yomitan'));
 });
 
 test('resolveExistingYomitanExtensionPath ignores source tree without built manifest', () => {

src/core/services/yomitan-extension-paths.ts

@@ -22,10 +22,12 @@ export function getYomitanExtensionSearchPaths(
   const searchPaths: string[] = [];
 
   pushUnique(searchPaths, options.explicitPath ? path.resolve(options.explicitPath) : null);
-  pushUnique(searchPaths, options.cwd ? path.resolve(options.cwd, 'dist', 'yomitan') : null);
+  pushUnique(searchPaths, options.cwd ? path.resolve(options.cwd, 'build', 'yomitan') : null);
   pushUnique(
     searchPaths,
-    options.moduleDir ? path.resolve(options.moduleDir, '..', '..', '..', 'dist', 'yomitan') : null,
+    options.moduleDir
+      ? path.resolve(options.moduleDir, '..', '..', '..', 'build', 'yomitan')
+      : null,
   );
   pushUnique(
     searchPaths,

src/main.ts

@@ -328,11 +328,9 @@ import {
   setMpvSubVisibilityRuntime,
   setOverlayDebugVisualizationEnabledRuntime,
   setVisibleOverlayVisible as setVisibleOverlayVisibleCore,
-  shiftSubtitleRangeToVideoClock,
   showMpvOsdRuntime,
   JellyfinPlaybackReporter,
   tokenizeSubtitle as tokenizeSubtitleCore,
-  toSubtitleClock,
   triggerFieldGrouping as triggerFieldGroupingCore,
   upsertYomitanDictionarySettings,
   updateLastCardFromClipboard as updateLastCardFromClipboardCore,
@@ -404,11 +402,7 @@ import {
   getConfiguredWindowsMpvPathStatus,
   launchWindowsMpv,
 } from './main/runtime/windows-mpv-launch';
-import {
-  findMpvExecutablePath,
-  resolveMpvExecutablePath,
-  spawnMpvProcess,
-} from './main/runtime/mpv-process';
+import { resolveMpvExecutablePath, spawnMpvProcess } from './main/runtime/mpv-process';
 import { createWaitForMpvConnectedHandler } from './main/runtime/jellyfin-remote-connection';
 import {
   DEFAULT_JELLYFIN_CLIENT_NAME,
@@ -1939,10 +1933,7 @@ let tokenizeSubtitleDeferred: ((text: string) => Promise<SubtitleData>) | null =
 function withCurrentSubtitleTiming(payload: SubtitleData): SubtitleData {
   const canonical = resolveCanonicalPrimarySubtitle({
     liveText: payload.text,
-    currentTimeSec: toSubtitleClock(
-      Number(appState.mpvClient?.currentTimePos),
-      appState.mpvClient?.currentSubDelay ?? 0,
-    ),
+    currentTimeSec: Number(appState.mpvClient?.currentTimePos),
     cues: appState.activeParsedSubtitleCues,
   });
   return {
@@ -1956,11 +1947,9 @@ function captureCurrentPrimarySubtitleMiningContext(): SubtitleMiningContext | n
   // Mine what the overlay shows, not raw mpv `sub-text`: the raw text lists every active
   // event, so a finished caption row lingering beside a fresh line would end up on the
   // card. The parsed view also carries the cue's own timings for the clip range.
-  // Cues sit on the subtitle clock, so the lookup undoes `sub-delay` first.
-  const subDelay = appState.mpvClient?.currentSubDelay ?? 0;
   const resolved = resolvePrimarySubtitle({
     liveText: appState.mpvClient?.currentSubText ?? '',
-    currentTimeSec: toSubtitleClock(Number(appState.mpvClient?.currentTimePos), subDelay),
+    currentTimeSec: Number(appState.mpvClient?.currentTimePos),
     cues: appState.activeParsedSubtitleCues,
   });
   // Same validity bar as the live capture path: an unusable resolved span must fall
@@ -1975,16 +1964,13 @@ function captureCurrentPrimarySubtitleMiningContext(): SubtitleMiningContext | n
   ) {
     return captureLiveSubtitleMiningContext(appState.mpvClient);
   }
-  return shiftSubtitleRangeToVideoClock<SubtitleMiningContext>(
-    {
-      source: 'overlay',
-      text: resolvedText,
-      startTime: resolved.startTime,
-      endTime: resolved.endTime,
-      capturedAtMs: Date.now(),
-    },
-    subDelay,
-  );
+  return {
+    source: 'overlay',
+    text: resolvedText,
+    startTime: resolved.startTime,
+    endTime: resolved.endTime,
+    capturedAtMs: Date.now(),
+  };
 }
 function emitSubtitlePayload(payload: SubtitleData, options?: { resumePrefetch?: boolean }): void {
   const timedPayload = withCurrentSubtitleTiming(payload);
@@ -2126,18 +2112,13 @@ function getSubtitleSidebarPlaybackState(): SubtitleSidebarPlaybackState {
     subtitleSidebarCuesRef = appState.activeParsedSubtitleCues;
     subtitleSidebarCuesRevision += 1;
   }
-  const subDelay = appState.mpvClient?.currentSubDelay ?? 0;
   return {
     sourceKey: JSON.stringify([
       appState.activeParsedSubtitleMediaPath,
       appState.activeParsedSubtitleSource,
     ]),
     cuesRevision: subtitleSidebarCuesRevision,
-    currentTimeSec:
-      appState.mpvClient?.currentTimePos === undefined
-        ? null
-        : toSubtitleClock(appState.mpvClient.currentTimePos, subDelay),
-    subDelay,
+    currentTimeSec: appState.mpvClient?.currentTimePos ?? null,
     currentSubtitle: {
       text: appState.currentSubText,
       startTime: appState.mpvClient?.currentSubStart ?? null,
@@ -2176,7 +2157,6 @@ function sendRendererMpvCommand(rawCommand: (string | number)[]): void {
       rawCommand,
       appState.activeParsedSubtitleCues,
       appState.mpvClient?.currentTimePos ?? Number.NaN,
-      appState.mpvClient?.currentSubDelay ?? 0,
     ) ?? rawCommand;
   if (isExplicitMpvSeekCommand(command)) {
     explicitSeekIntentExpiresAtMs = Date.now() + EXPLICIT_SEEK_INTENT_TTL_MS;
@@ -3099,11 +3079,8 @@ const mediaTimingReviewRuntime = createMediaTimingReviewRuntime({
   getMpvClient: () => appState.mpvClient,
   getCurrentMediaPath: () =>
     appState.currentMediaPath?.trim() || appState.mpvClient?.currentVideoPath?.trim() || null,
-  // An invalid configured path is passed through so the preview fails instead of using PATH mpv.
-  getMpvExecutablePath: () => {
-    const configuredPath = configService.getConfig().mpv.executablePath;
-    return findMpvExecutablePath(configuredPath) || configuredPath;
-  },
+  getMpvExecutablePath: () =>
+    configService.getConfig().mpv.executablePath || process.env.SUBMINER_MPV_PATH?.trim() || '',
   createPreviewSession: () => new MediaTimingPreviewSession(),
   generateWaveform: (options) => generateSpeechWaveform(options),
   generateFrame: (options) => mediaTimingFrameExtractor.generate(options),
@@ -3131,10 +3108,7 @@ const mediaTimingReviewRuntime = createMediaTimingReviewRuntime({
   acquireMediaWindow: (source, range) => getSharedRemoteMediaWindowCache().acquire(source, range),
   getSubtitleContextLines: (range) =>
     collectMediaTimingContextLines({
-      // Review ranges and tracker entries are on the video clock; parsed cues are not.
-      cues: appState.activeParsedSubtitleCues.map((cue) =>
-        shiftSubtitleRangeToVideoClock(cue, appState.mpvClient?.currentSubDelay ?? 0),
-      ),
+      cues: appState.activeParsedSubtitleCues,
       fallbackPrevious: appState.subtitleTimingTracker?.getRecentEntries(40) ?? [],
       startTime: range.startTime,
       endTime: range.endTime,
@@ -6047,11 +6021,7 @@ const { registerIpcRuntimeHandlers } = composeIpcRuntimeHandlers({
       // live mpv sub timings at lookup time so media generation clips the mined line even
       // when extraction finishes long after playback has moved on.
       recordSubtitleMiningContext: (context) =>
-        recordSubtitleMiningContext(
-          context
-            ? shiftSubtitleRangeToVideoClock(context, appState.mpvClient?.currentSubDelay ?? 0)
-            : captureCurrentPrimarySubtitleMiningContext(),
-        ),
+        recordSubtitleMiningContext(context ?? captureCurrentPrimarySubtitleMiningContext()),
       tokenizeCurrentSubtitle: async () => {
         const tokenizeSubtitleForCurrent = tokenizeSubtitleDeferred;
         return resolveCurrentSubtitleForRenderer({

src/main/runtime/autoplay-subtitle-priming-runtime.ts

@@ -1,4 +1,3 @@
-import { toSubtitleClock } from '../../core/services/subtitle-clock';
 import type { SubtitleCue, SubtitleData } from '../../types';
 import { selectAutoplayStartupCue } from './autoplay-subtitle-primer';
 import { primeVisibleOverlaySubtitleFromMpv } from './current-subtitle-snapshot';
@@ -13,7 +12,6 @@ type AutoplaySubtitlePrimingMpvClient = {
   requestProperty: (name: string) => Promise<unknown>;
   currentVideoPath?: string;
   currentTimePos?: number;
-  currentSubDelay?: number;
   currentSubText?: string;
   currentSecondarySubText?: string;
   setCurrentSecondarySubText?: (text: string) => void;
@@ -158,7 +156,7 @@ export function createAutoplaySubtitlePrimingRuntime(deps: AutoplaySubtitlePrimi
     const currentTimeSec = Number(client?.currentTimePos ?? deps.getLastObservedTimePos());
     return resolvePrimarySubtitleText({
       liveText: text,
-      currentTimeSec: toSubtitleClock(currentTimeSec, client?.currentSubDelay ?? 0),
+      currentTimeSec,
       cues: deps.getActiveParsedSubtitleCues(),
     });
   }
@@ -272,10 +270,7 @@ export function createAutoplaySubtitlePrimingRuntime(deps: AutoplaySubtitlePrimi
     const currentTimeSeconds = Number(
       timePosRaw ?? client?.currentTimePos ?? deps.getLastObservedTimePos() ?? 0,
     );
-    const resolvedTimeSeconds = toSubtitleClock(
-      Number.isFinite(currentTimeSeconds) ? currentTimeSeconds : 0,
-      client?.currentSubDelay ?? 0,
-    );
+    const resolvedTimeSeconds = Number.isFinite(currentTimeSeconds) ? currentTimeSeconds : 0;
     const cue = selectAutoplayStartupCue(
       cues,
       resolvedTimeSeconds,

src/main/runtime/mpv-main-event-main-deps.test.ts

@@ -176,21 +176,6 @@ test('subtitle-track transitions ignore stale parsed cues until replacement cues
   assert.deepEqual(recordedStarts.slice(-1), [20]);
 });
 
-test('subtitle timing history records lines on the video clock under sub-delay', () => {
-  const timing: Array<{ text: string; start: number; end: number }> = [];
-  const { handlers } = buildMainDeps({
-    mpvClient: { currentSubDelay: 2 },
-    subtitleTimingTracker: {
-      recordSubtitle: (text: string, start: number, end: number) =>
-        timing.push({ text, start, end }),
-    },
-  });
-
-  handlers.recordSubtitleTiming('食べる', 5, 8);
-
-  assert.deepEqual(timing, [{ text: '食べる', start: 7, end: 10 }]);
-});
-
 test('canonical ASS cues replace live glyph spam for display, history, and immersion', () => {
   const immersion: Array<{ text: string; start: number; end: number }> = [];
   const timing: Array<{ text: string; start: number; end: number }> = [];

src/main/runtime/mpv-main-event-main-deps.ts

@@ -1,4 +1,3 @@
-import { toSubtitleClock } from '../../core/services/subtitle-clock';
 import { createSubtitleLineDedupGate } from '../../core/services/subtitle-line-dedup-gate';
 import type { MergedToken, SubtitleCue, SubtitleData } from '../../types';
 import {
@@ -24,7 +23,6 @@ export function createBuildBindMpvMainEventHandlersMainDepsHandler(deps: {
       currentSubText?: string;
       currentSecondarySubText?: string;
       currentTimePos?: number;
-      currentSubDelay?: number;
       requestProperty?: (name: string) => Promise<unknown>;
     } | null;
     immersionTracker: {
@@ -163,10 +161,7 @@ export function createBuildBindMpvMainEventHandlersMainDepsHandler(deps: {
     resolveSubtitleText: (liveText: string) =>
       resolvePrimarySubtitleText({
         liveText,
-        currentTimeSec: toSubtitleClock(
-          Number(deps.appState.mpvClient?.currentTimePos),
-          deps.appState.mpvClient?.currentSubDelay ?? 0,
-        ),
+        currentTimeSec: Number(deps.appState.mpvClient?.currentTimePos),
         cues: deps.appState.activeParsedSubtitleCues,
       }),
     getCurrentLiveSubtitleText: () => deps.appState.mpvClient?.currentSubText ?? '',
@@ -236,9 +231,6 @@ export function createBuildBindMpvMainEventHandlersMainDepsHandler(deps: {
     hasSubtitleTimingTracker: () => Boolean(deps.appState.subtitleTimingTracker),
     recordSubtitleTiming: (text: string, start: number, end: number) => {
       const secondaryText = deps.appState.mpvClient?.currentSecondarySubText || undefined;
-      // The tracker feeds multi-line mining, so it stores video-clock times: the subtitle
-      // timings plus the `sub-delay` in effect while the line was on screen.
-      const subDelay = deps.appState.mpvClient?.currentSubDelay ?? 0;
       const canonical = resolveCanonicalSample(text, start);
       if (!canonical) {
         const recordableText = resolveTextForRecording(text, start);
@@ -247,8 +239,8 @@ export function createBuildBindMpvMainEventHandlersMainDepsHandler(deps: {
         }
         deps.appState.subtitleTimingTracker?.recordSubtitle?.(
           recordableText,
-          start + subDelay,
-          end + subDelay,
+          start,
+          end,
           secondaryText,
         );
         return;
@@ -261,8 +253,8 @@ export function createBuildBindMpvMainEventHandlersMainDepsHandler(deps: {
         recordedTimingCanonicalKeys.add(key);
         deps.appState.subtitleTimingTracker?.recordSubtitle?.(
           cue.text,
-          cue.startTime + subDelay,
-          cue.endTime + subDelay,
+          cue.startTime,
+          cue.endTime,
           secondaryText,
         );
       }

src/main/runtime/mpv-process.test.ts

@@ -5,11 +5,9 @@ import os from 'node:os';
 import path from 'node:path';
 import test from 'node:test';
 import {
-  createPosixMpvPathDeps,
   createWindowsMpvPathDeps,
   getConfiguredWindowsMpvPathStatus,
   resolveMpvExecutablePath,
-  resolvePosixMpvPath,
   resolveWindowsMpvPath,
   spawnMpvProcess,
 } from './mpv-process';
@@ -97,79 +95,6 @@ test('resolveWindowsMpvPath returns blank when nothing resolves', () => {
   assert.equal(resolveWindowsMpvPath(missing.deps), '');
 });
 
-// launchd's default PATH, which apps opened from Finder, the Dock, or Spotlight inherit.
-const LAUNCHD_PATH = '/usr/bin:/bin:/usr/sbin:/sbin';
-
-function makePosixDeps(options: {
-  platform: NodeJS.Platform;
-  executables?: string[];
-  env?: Record<string, string>;
-}) {
-  const executables = new Set(options.executables ?? []);
-  return createPosixMpvPathDeps({
-    platform: options.platform,
-    getEnv: (name) => options.env?.[name],
-    isExecutable: (candidate) => executables.has(candidate),
-  });
-}
-
-test('resolvePosixMpvPath prefers a configured executable and does not fall back when it is invalid', () => {
-  const deps = makePosixDeps({
-    platform: 'darwin',
-    executables: ['/cfg/mpv', '/opt/homebrew/bin/mpv'],
-    env: { PATH: LAUNCHD_PATH },
-  });
-
-  assert.equal(resolvePosixMpvPath(deps, '  /cfg/mpv  '), '/cfg/mpv');
-  assert.equal(resolvePosixMpvPath(deps, '/missing/mpv'), '');
-});
-
-test('resolvePosixMpvPath uses SUBMINER_MPV_PATH before searching PATH', () => {
-  const deps = makePosixDeps({
-    platform: 'linux',
-    executables: ['/env/mpv', '/usr/bin/mpv'],
-    env: { SUBMINER_MPV_PATH: ' /env/mpv ', PATH: '/usr/bin' },
-  });
-
-  assert.equal(resolvePosixMpvPath(deps), '/env/mpv');
-});
-
-test('resolvePosixMpvPath takes the first PATH entry that has mpv', () => {
-  const deps = makePosixDeps({
-    platform: 'darwin',
-    executables: ['/second/mpv', '/third/mpv', '/opt/homebrew/bin/mpv'],
-    env: { SUBMINER_MPV_PATH: '/stale/mpv', PATH: '/first::/second:/third' },
-  });
-
-  assert.equal(resolvePosixMpvPath(deps), '/second/mpv');
-});
-
-test('resolvePosixMpvPath finds Homebrew mpv on macOS when the app only has the launchd PATH', () => {
-  const homebrew = makePosixDeps({
-    platform: 'darwin',
-    executables: ['/opt/homebrew/bin/mpv'],
-    env: { PATH: LAUNCHD_PATH },
-  });
-  const appBundle = makePosixDeps({
-    platform: 'darwin',
-    executables: ['/Applications/mpv.app/Contents/MacOS/mpv'],
-    env: { PATH: LAUNCHD_PATH },
-  });
-
-  assert.equal(resolvePosixMpvPath(homebrew), '/opt/homebrew/bin/mpv');
-  assert.equal(resolvePosixMpvPath(appBundle), '/Applications/mpv.app/Contents/MacOS/mpv');
-});
-
-test('resolvePosixMpvPath only probes macOS install locations on macOS', () => {
-  const deps = makePosixDeps({
-    platform: 'linux',
-    executables: ['/opt/homebrew/bin/mpv'],
-    env: { PATH: LAUNCHD_PATH },
-  });
-
-  assert.equal(resolvePosixMpvPath(deps), '');
-});
-
 const X11_SPAWN_CASES = [
   {
     name: 'forces the X11 backend for an unsupported Wayland session',

src/main/runtime/mpv-process.ts

@@ -1,5 +1,4 @@
 import fs from 'node:fs';
-import path from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
 import {
   MPV_X11_BACKEND_ARGS,
@@ -99,74 +98,14 @@ export function spawnMpvProcess(
   });
 }
 
-export interface PosixMpvPathDeps {
-  platform: NodeJS.Platform;
-  getEnv: (name: string) => string | undefined;
-  isExecutable: (candidate: string) => boolean;
-}
-
-// Apps opened from Finder, the Dock, or Spotlight inherit launchd's minimal PATH
-// (/usr/bin:/bin:/usr/sbin:/sbin), so Homebrew and app-bundle installs are probed directly.
-const MACOS_MPV_FALLBACK_PATHS = [
-  '/opt/homebrew/bin/mpv',
-  '/usr/local/bin/mpv',
-  '/Applications/mpv.app/Contents/MacOS/mpv',
-];
-
-function isExecutableFile(candidate: string): boolean {
-  try {
-    fs.accessSync(candidate, fs.constants.X_OK);
-    return fs.statSync(candidate).isFile();
-  } catch {
-    return false;
-  }
-}
-
-export function createPosixMpvPathDeps(
-  overrides: Partial<PosixMpvPathDeps> = {},
-): PosixMpvPathDeps {
-  return {
-    platform: overrides.platform ?? process.platform,
-    getEnv: overrides.getEnv ?? ((name) => process.env[name]),
-    isExecutable: overrides.isExecutable ?? isExecutableFile,
-  };
-}
-
-// Resolution order: mpv.executablePath, SUBMINER_MPV_PATH, PATH, then macOS install
-// locations. A configured path that is not executable resolves to '' instead of falling back.
-export function resolvePosixMpvPath(deps: PosixMpvPathDeps, configuredMpvPath = ''): string {
-  const configPath = configuredMpvPath.trim();
-  if (configPath) {
-    return deps.isExecutable(configPath) ? configPath : '';
-  }
-
-  const envPath = deps.getEnv('SUBMINER_MPV_PATH')?.trim();
-  if (envPath && deps.isExecutable(envPath)) {
-    return envPath;
-  }
-
-  const pathCandidates = (deps.getEnv('PATH') ?? '')
-    .split(path.posix.delimiter)
-    .filter((dir) => dir.length > 0)
-    .map((dir) => path.posix.join(dir, 'mpv'));
-  const candidates =
-    deps.platform === 'darwin' ? [...pathCandidates, ...MACOS_MPV_FALLBACK_PATHS] : pathCandidates;
-  return candidates.find((candidate) => deps.isExecutable(candidate)) ?? '';
-}
-
-// Returns the mpv binary SubMiner should spawn itself, or '' when none is found.
-export function findMpvExecutablePath(configuredMpvPath = ''): string {
-  return process.platform === 'win32'
-    ? resolveWindowsMpvPath(createWindowsMpvPathDeps(), configuredMpvPath)
-    : resolvePosixMpvPath(createPosixMpvPathDeps(), configuredMpvPath);
-}
-
 export function resolveMpvExecutablePath(configuredMpvPath = ''): string {
-  const executablePath = findMpvExecutablePath(configuredMpvPath);
+  const executablePath =
+    process.platform === 'win32'
+      ? resolveWindowsMpvPath(createWindowsMpvPathDeps(), configuredMpvPath)
+      : 'mpv';
   if (!executablePath) {
-    const binary = process.platform === 'win32' ? 'mpv.exe' : 'mpv';
     throw new Error(
-      `Could not find ${binary}. Check mpv.executablePath, SUBMINER_MPV_PATH, or PATH.`,
+      'Could not find mpv.exe. Check mpv.executablePath, SUBMINER_MPV_PATH, or PATH.',
     );
   }
   return executablePath;

src/renderer/handlers/keyboard.test.ts

@@ -481,8 +481,6 @@ function installKeyboardTestGlobals() {
     setSessionBindings: (value: CompiledSessionBinding[]) => {
       sessionBindings = value;
     },
-    // A plain overlay element over playback, outside any SubMiner UI.
-    createPlaybackTarget: () => new TestElement(),
     createInteractiveTarget: () => {
       const target = new TestElement();
       target.closest = (selector: string) => (selector.includes('.modal') ? target : null);
@@ -1299,42 +1297,6 @@ test('Hachidori attention without an open popup pane still forwards imported mpv
   }
 });
 
-test('an open subtitle sidebar only keeps imported mpv input aimed at the sidebar', async () => {
-  const { ctx, handlers, testGlobals } = createKeyboardHandlerHarness();
-
-  try {
-    testGlobals.setGetMpvInputBindings(async () => ({
-      keys: ['0', 'MBTN_LEFT_DBL'],
-      blockedKeys: [],
-    }));
-    await handlers.setupMpvInputForwarding();
-    await wait(0);
-    ctx.state.subtitleSidebarModalOpen = true;
-    const sidebarTarget = testGlobals.createInteractiveTarget();
-    const playbackTarget = testGlobals.createPlaybackTarget();
-
-    // Sidebar input runs first, while no key or button is held, so a held key cannot
-    // hide a forwarded press. Its release has no matching press to forward.
-    testGlobals.dispatchKeydown({ key: '0', code: 'Digit0', target: sidebarTarget });
-    testGlobals.dispatchMousedown({ button: 0, target: sidebarTarget });
-    testGlobals.dispatchMousedown({ button: 0, type: 'mouseup', target: sidebarTarget });
-    assert.deepEqual(testGlobals.mpvCommands, []);
-
-    testGlobals.dispatchKeydown({ key: '0', code: 'Digit0', target: playbackTarget });
-    testGlobals.dispatchMousedown({ button: 0, target: playbackTarget });
-    testGlobals.dispatchMousedown({ button: 0, type: 'mouseup', target: playbackTarget });
-
-    assert.deepEqual(testGlobals.mpvCommands, [
-      ['keydown', '0'],
-      ['keydown', 'MBTN_LEFT'],
-      ['keyup', 'MBTN_LEFT'],
-    ]);
-  } finally {
-    ctx.state.subtitleSidebarModalOpen = false;
-    testGlobals.restore();
-  }
-});
-
 test('keyboard mode: lookup toggle opens a lookup during Hachidori attention without a pane', async () => {
   const { ctx, handlers, testGlobals } = createKeyboardHandlerHarness();
 

src/renderer/handlers/keyboard.ts

@@ -123,13 +123,12 @@ export function createKeyboardHandlers(
   }
 
   // Imported mpv bindings only run when no SubMiner UI could be the input's target.
-  // The subtitle sidebar is a side panel over playback, so only input inside it (a
-  // `.modal` target) stays with SubMiner.
   function canForwardToMpv(target: EventTarget | null): boolean {
     return (
       keyboardConfigLoaded &&
       !ctx.state.playlistBrowserModalOpen &&
       !ctx.state.youtubePickerModalOpen &&
+      !ctx.state.subtitleSidebarModalOpen &&
       !isLookupPopupOpen(ctx.state, document) &&
       !isInteractiveTarget(target)
     );