feat: use cached annotations on subtitle change and skip pre-warmed cues (#97)

* style: update subtitle text shadow, JLPT underlines, and frequency topX

- Replace directional text-shadow with 4-corner outline shadow for sharper readability
- Increase JLPT level border-bottom from 2px to 3px; add drop-shadow filter
- Add margin-left 0.18em to character image token
- Raise frequencyDictionary topX default from 1000 to 10000

* docs: add subtitle style changelog fragment

* docs: update generated config examples

* style: wrap long textShadow strings and add blank line in CSS

changes/358-jellyfin-setup-feedback.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Fixed the Jellyfin setup popup login path on Windows by using an IPC bridge, showing immediate login progress, and timing out unreachable server login attempts with an inline error.

changes/anilist-progress.md

@@ -0,0 +1,6 @@
+type: fixed
+area: anilist
+
+- Used fresh mpv time-position, duration, and subtitle timing events for AniList post-watch threshold checks so progress updates still fire when playback reaches or skips past the watched threshold.
+- Prefer season-specific AniList search results for multi-season files before falling back to the base title, and show a clear message when the matched season is not in Planning or Watching instead of silently queueing an impossible update.
+- Prevent repeated missing-token checks from rapidly exhausting AniList retry attempts or duplicating dead-letter entries for the same episode.

changes/animated-avif-padding-freeze.md

@@ -1,5 +0,0 @@
-type: fixed
-area: anki
-
-- Made sentence-audio padding opt-in by default, and kept animated AVIF motion aligned when padding is configured by freezing the first frame during leading audio padding.
-- Kept multi-line sentence mining aligned when repeated subtitle text appears in the selected history range.

changes/aniskip-key-learn.md

@@ -1,4 +0,0 @@
-type: changed
-area: config
-
-- Settings: Changed the AniSkip button key setting to use click-to-learn key capture instead of raw text entry.

changes/anki-mining.md

@@ -0,0 +1,10 @@
+type: fixed
+area: anki
+
+- Made sentence-audio padding opt-in by default, and kept animated AVIF freeze-frame duration aligned to the word audio length without double-counting sentence audio padding.
+- Kept multi-line sentence mining aligned when repeated subtitle text appears in the selected history range.
+- Fixed Kiku duplicate-card detection so local duplicate sentence cards trigger the manual modal or auto merge, modal-open acknowledgement races no longer cancel the flow, and merged fields follow Kiku's group ordering, sentence-audio, furigana, and tag semantics.
+- Fixed manual clipboard card updates from YouTube playback so generated audio and images use mpv's resolved stream URLs instead of the YouTube page URL.
+- Sentence cards now refresh the current secondary subtitle before saving, so the translation field uses the loaded subtitle instead of repeating the primary text.
+- Fixed immediate known-word cache append when no default Anki mining deck is configured but multiple known-word deck field mappings are present.
+- Added an AnkiConnect deck dropdown at the top of Mining & Anki settings that auto-fills from Yomitan's current mining deck when available.

changes/auto-update.md

@@ -1,4 +1,4 @@
 type: added
 area: updater
 
-- Added tray and `subminer -u` update checks for SubMiner releases, including app update prompts, launcher updates, Linux rofi theme updates, checksum verification, configurable update notifications, and an opt-in prerelease update channel for beta/RC testing.
+- Added tray and `subminer -u` update checks for SubMiner releases, including app update prompts, launcher and Linux rofi theme updates, checksum verification, configurable update notifications, and an opt-in prerelease channel. Set `updates.channel` to `"prerelease"` to receive beta/RC builds.

changes/background-launcher-reuse.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- Reused an already-running background SubMiner app for launcher-opened videos, closed launcher-owned tray apps after playback ends, and reapplied preferred subtitles for warm launches.

changes/changelog-net-release-outcome.md

@@ -1,4 +0,0 @@
-type: changed
-area: release
-
-- Release-note polishing now treats pending fragments and reviewed prerelease notes as a cumulative final outcome, so prerelease-only fixes or breakages collapse into the final user-facing change.

changes/character-dictionary-fixes.md

@@ -0,0 +1,8 @@
+type: fixed
+area: character-dictionary
+
+- Reused cached character-dictionary media matches so loading a title with an existing snapshot no longer sends another AniList search request.
+- Block the character dictionary manager when annotations are disabled, with a notice through the configured OSD/system notification surfaces.
+- Added surname honorific matches for Japanese localized character aliases embedded in AniList alternative names (e.g. Korean-source characters with Japanese names in parentheses), and refresh cached snapshots so those aliases are regenerated.
+- Use `subtitleStyle.nameMatchEnabled` as the only switch for character-dictionary sync/builds, hiding the legacy `anilist.characterDictionary.enabled` option.
+- Forward character dictionary manager session-action keybindings to the mpv plugin.

changes/character-dictionary-known-names.md

@@ -1,4 +0,0 @@
-type: changed
-area: dictionary
-
-- Keep character dictionary lookup entries scoped to generated Japanese name aliases instead of surfacing raw romanized/English aliases as separate results, and refresh cached v15 snapshots so old English-name entries are regenerated.

changes/character-dictionary-manager.md

@@ -1,4 +0,0 @@
-type: changed
-area: character-dictionary
-
-- Character dictionary entries are now scoped to the current AniList media for name matching and inline portraits, and a new `Ctrl/Cmd+D` manager modal can remove, reorder, or override loaded dictionary entries.

changes/character-dictionary-manual-search.md

@@ -1,4 +0,0 @@
-type: changed
-area: character-dictionary
-
-- **Character Dictionary:** Changed the in-app AniList selector to wait for an explicit title search. The search box is prefilled from the current filename guess, so you can edit it before choosing an override.

changes/character-dictionary-resolution-cache.md

@@ -1,4 +0,0 @@
-type: fixed
-area: character-dictionary
-
-- Reused cached character-dictionary media matches so loading a title with an existing snapshot no longer sends another AniList search request.

changes/character-dictionary.md

@@ -0,0 +1,6 @@
+type: changed
+area: character-dictionary
+
+- Character dictionary entries are now scoped to the current AniList media for name matching and inline portraits, and generate Japanese name aliases only so raw romanized/English aliases no longer surface as separate results.
+- Added a `Ctrl/Cmd+D` manager modal to remove, reorder, or override loaded dictionary entries.
+- The in-app AniList selector now waits for an explicit title search, with the search box prefilled from the current filename guess so you can edit it before choosing an override.

changes/config-example-settings-css.md

@@ -1,4 +0,0 @@
-type: fixed
-area: config
-
-- Updated the generated example config to use the same CSS declaration paths written by the Settings window for subtitle and sidebar appearance.

changes/config-load-preserves-user-files.md

@@ -1,4 +0,0 @@
-type: fixed
-area: config
-
-- Preserved user config files during legacy config compatibility handling.

changes/config-settings-controls.md

@@ -1,4 +0,0 @@
-type: changed
-area: config
-
-- Reorganized the Settings window into clearer Appearance, Behavior, Anki, input, and integration sections with learned keybinding controls and AnkiConnect-backed deck, field, and note-type pickers.

changes/config-settings-search.md

@@ -1,4 +0,0 @@
-type: fixed
-area: config
-
-- Fixed Settings window search so it searches across all categories, narrows on multi-word terms, hides settings owned by richer editors, and no longer shows the Open File button.

changes/config-settings-window.md

@@ -1,8 +0,0 @@
-type: added
-area: config
-
-- Added a dedicated Settings window with launcher entry points via `subminer --settings` and `subminer settings`.
-- Fixed the Settings window preload so launcher-opened windows can initialize even when Electron sandboxing is active.
-- Kept settings-window startup lightweight by skipping AniList token refresh and automatic update polling.
-- Marked safe live config options in the Settings window and expanded hot reload for stats keys, logging level, Jimaku, Subsync, YouTube language defaults, Anki media/sentence/misc field mappings, sentence card model, and selected Anki annotation/runtime options.
-- Hid AI and translation fields from the Settings window while keeping them supported in config files.

changes/docs-versioning.md

@@ -1,4 +0,0 @@
-type: docs
-area: docs
-
-- Published stable docs at the site root with current development docs under `/main/`.

changes/docs.md

@@ -0,0 +1,6 @@
+type: docs
+area: docs
+
+- Published stable docs at the site root with current development docs under `/main/`, and fixed versioned docs navigation so archived pages keep local links under the selected version, the version switcher no longer nests paths incorrectly, local dev version routes serve warmed archive files, and internal README files no longer break archived builds.
+- Documented all previously undocumented config options, including `subtitleStyle.primaryDefaultMode`, `stats.markWatchedKey`, `immersionTracking.lifetimeSummaries.*`, and all seven `mpv.*` launcher options.
+- Added a Playback Startup Flow diagram and a Runtime Sockets section/diagram to the architecture docs, with cross-reference pointers in the MPV Plugin and Troubleshooting pages.

changes/first-run-command-line-launcher.md

@@ -1,5 +0,0 @@
-type: added
-area: setup
-
-- Added optional first-run setup controls to install Bun and the `subminer` command-line launcher on Linux, macOS, and Windows.
-- Added a Windows `subminer.cmd` user PATH shim so users can type `subminer` without adding `SubMiner.exe` to PATH.

changes/fix-anilist-timepos-threshold.md

@@ -1,6 +0,0 @@
-type: fixed
-area: anilist
-
-- Used fresh mpv time-position, duration, and subtitle timing events for AniList post-watch threshold checks so progress updates still fire when playback reaches or skips past the watched threshold.
-- Prefer season-specific AniList search results for multi-season files before falling back to the base title.
-- Show a clear AniList message when the matched season is not in Planning or Watching instead of silently queueing an impossible progress update.

changes/fix-animated-avif-word-audio-sync.md

@@ -1,4 +0,0 @@
-type: fixed
-area: anki
-
-- Fixed animated AVIF word-audio sync so the frozen lead-in matches the word audio duration without adding sentence audio padding a second time.

changes/fix-autoplay-subtitle-prime.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Primed the first startup subtitle before autoplay resumes so the overlay can render text before video playback begins.

changes/fix-background-attach-autoplay-gate.md

@@ -1,5 +0,0 @@
-type: fixed
-area: launcher
-
-- Kept launcher-opened videos paused when attaching to an already-running background app until subtitle priming and tokenization readiness complete.
-- Moved mpv plugin subtitle auto-selection to pre-load so launch-time subtitle choices are not reset after the video opens.

changes/fix-character-dictionary-modal-hyprland.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Hid the visible subtitle overlay as soon as the character dictionary modal opens, including while AniList lookup is still loading or returns no results.

changes/fix-determiner-noun-frequency.md

@@ -1,4 +0,0 @@
-type: fixed
-area: subtitles
-
-- Kept frequency highlighting for determiner-led noun compounds like `その場` while still filtering standalone determiners.

changes/fix-hyprland-overlay-unfullscreen.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Refreshed Linux overlay placement after leaving mpv fullscreen so Hyprland keeps the visible overlay aligned to the player.

changes/fix-hyprland-overlay-zorder.md

@@ -1,5 +0,0 @@
-type: fixed
-area: overlay
-
-- Kept the Hyprland visible overlay stacked above mpv after mpv receives focus from clicks or overlay movement.
-- Suspended the visible overlay while the in-player stats window is open, then restored it mouse-passive after stats closes.

changes/fix-hyprland-settings-window-z-order.md

@@ -1,4 +0,0 @@
-type: fixed
-area: desktop
-
-- Fixed Hyprland settings windows opening behind the subtitle overlay by promoting SubMiner and Yomitan settings above the overlay without hiding subtitles.

changes/fix-jellyfin-discovery-playback-loop.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Prevented Jellyfin discovery playback from reloading the active item, misreporting paused mpv playback as still playing, retrying startup unpause after playback is paused again, unpausing after a manual `y-t` overlay toggle during startup, repeatedly restoring the overlay from duplicate ready signals, missing delayed Japanese subtitle selection on startup, letting later German/Russian subtitle loads steal the selected Japanese track, and spawning long-lived sidebar ffmpeg extractors against Jellyfin stream URLs.

changes/fix-jellyfin-discovery-resume.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Fixed Jellyfin discovery resume playback when a remote play command sends `StartPositionTicks: 0` despite saved progress on the item.

changes/fix-jellyfin-host-device-identity.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Derived Jellyfin cast device identity from the OS hostname, always reports the client as SubMiner, and ignores legacy configurable Jellyfin client/device identity fields so multiple SubMiner installs no longer share the same remote-session identity.

changes/fix-jellyfin-overlay-toggle.md

@@ -1,11 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Fixed Jellyfin `y-t` overlay hide so the plugin sends an explicit hide command when it knows the overlay is visible, avoiding overlay reloads and paused playback resumes.
-- Kept that manual hide sticky across Jellyfin stream redirects that change mpv's path, even when the redirected URL drops mpv's media title.
-- Re-armed managed subtitle defaults during those path-changing redirects so Japanese primary subtitles can load on the redirected stream.
-- Routed visible-overlay shortcuts and app-side visibility changes back through the mpv plugin so SubMiner overlay toggling stays independent of Jellyfin playback controls.
-- Collapsed duplicate visible-overlay toggle events so Hyprland does not process one physical shortcut as hide-then-show.
-- Kept passive Linux/Hyprland visible-overlay shows from taking keyboard focus away from mpv/Jellyfin.
-- Made Jellyfin external subtitle selection tolerate transient mpv `track-list` read failures and numeric string track IDs so Japanese subtitles are selected after preload on Linux.
-- Fixed AppImage-launched Jellyfin playback controls so mpv sends overlay commands to the running SubMiner app-control socket instead of the mounted Electron binary.

changes/fix-jellyfin-remote-progress-sync.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Fixed Jellyfin remote controller visibility and progress syncing for mpv/SubMiner seek jumps, stopped sessions, startup path changes, and Linux websocket reconnect windows.

changes/fix-jellyfin-stats-title.md

@@ -1,4 +0,0 @@
-type: fixed
-area: stats
-
-- Grouped Jellyfin playback stats under Jellyfin item metadata instead of stream URLs, so watched episodes merge with matching local library titles and keep clean display names.

changes/fix-jellyfin-subtitle-timing.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Improved Jellyfin subtitle timing behavior by preferring default embedded subtitle streams over external sidecars, stripping Jellyfin's server-selected subtitle stream from mpv playback URLs, suppressing mpv's subtitle auto-selection and plugin overlay auto-start while SubMiner stages managed tracks, automatically correcting clear Japanese-vs-English cue timeline offsets, and restoring saved per-stream subtitle delay shifts.

changes/fix-jellyfin-tray-discovery-active-state.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Keep the Jellyfin discovery tray checkbox in sync on Linux after tray, CLI, or startup remote-session changes, with a visible check mark when Linux tray hosts ignore native checkbox rendering.

changes/fix-jellyfin-tray-discovery-stale-session.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Restarted stale Jellyfin tray discovery sessions when the server no longer lists the SubMiner cast target, avoiding a needless Jellyfin re-login.

changes/fix-jellyfin-visible-progress.md

@@ -1,5 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Preserved Jellyfin-visible resume progress when mpv resets its position during playback stop by reusing SubMiner's last known playback position for final progress and stopped reports.
-- Kept Jellyfin remote Play and Resume distinct so normal Play starts from the beginning, while Resume starts at Jellyfin's requested position without an early mpv seek race.

changes/fix-launcher-electron-menu-diagnostic.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- Suppressed Electron macOS menu diagnostics from `subminer settings` launcher output.

changes/fix-linux-app-command-detach.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- Fixed `subminer app` on Linux so launching the tray app returns control to the terminal immediately instead of waiting for the tray process to exit.

changes/fix-macos-mpv-shortcuts.md

@@ -1,4 +0,0 @@
-type: fixed
-area: shortcuts
-
-- Disabled native mpv menu shortcuts during managed macOS playback so configured SubMiner shortcuts also work while mpv has focus.

changes/fix-macos-overlay-layering.md

@@ -1,10 +0,0 @@
-type: fixed
-area: overlay
-
-- Hid the macOS visible overlay when mpv is no longer the foreground target so other apps and Spaces are not covered by SubMiner subtitles.
-- Kept the macOS overlay layered above active mpv while stats mouse passthrough is enabled, and treated the frontmost mpv app as the focus signal.
-- Opened the stats overlay inactive on macOS so it appears over fullscreen mpv instead of switching back to SubMiner's original desktop.
-- Preserved the active mpv focus state through transient macOS helper misses so subtitles do not flicker while mpv remains foreground.
-- Kept fullscreen macOS overlays stable when mpv remains frontmost but window geometry temporarily disappears from the macOS window APIs.
-- Released the macOS overlay when the helper reports mpv is no longer foreground so other apps are no longer covered.
-- Reduced macOS window-tracker background work by preferring the compiled helper and slowing polls while mpv is stably focused.

changes/fix-macos-overlay-minimize-tracking.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Fixed macOS overlay tracking so transient mpv window misses no longer hide the overlay; minimizing mpv still hides it.

changes/fix-macos-overlay-passthrough.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Fixed macOS overlay passthrough so mpv controls remain clickable before hovering subtitle bars.

changes/fix-managed-playback-overlay-lifecycle.md

@@ -1,4 +0,0 @@
-type: fixed
-area: playback
-
-- Fixed managed mpv startup so launcher-owned videos quit SubMiner when playback ends, background/tray sessions stay alive, and pause-until-ready waits for the overlay and tokenization readiness before playback resumes.

changes/fix-multiline-copy-overlay-focus.md

@@ -1,4 +0,0 @@
-type: fixed
-area: shortcuts
-
-- Focus the visible overlay when entering multi-line copy/mine selection so number keys choose the line count on macOS and Windows.

changes/fix-prerelease-update-channel.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Clarified that beta/RC update checks are controlled by `updates.channel`; set it to `"prerelease"` to receive beta/RC updates.

changes/fix-sidebar-yomitan-popup-pause.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Kept playback paused for Yomitan lookup popups opened from the subtitle sidebar when popup auto-pause is enabled.

changes/fix-stats-dialog-layering.md

@@ -1,4 +0,0 @@
-type: fixed
-area: stats
-
-- Stats: Fixed in-player stats layering so delete confirmations, overlay modals, and update-check dialogs appear above the stats window.

changes/fix-subsync-modal-window.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Fixed subtitle sync modal opens so macOS no longer flashes and hides the first modal attempt or leaves stale modal state after syncing.

changes/fix-versioned-doc-links.md

@@ -1,4 +0,0 @@
-type: fixed
-area: docs
-
-- Fixed versioned docs navigation so archived pages keep local links under the selected version, the version switcher no longer nests targets under the current archive path, local dev version routes serve warmed archive files instead of redirecting to production or falling through to VitePress 404s, and internal README files do not break archived builds.

changes/fix-windows-background-mpv-overlay.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Fixed Windows managed mpv launches from a background SubMiner instance so the existing warm app receives the start command, retargets the new mpv socket, binds to the player window, and receives startup overlay options.

changes/fix-youtube-manual-card-update-media.md

@@ -1,4 +0,0 @@
-type: fixed
-area: anki
-
-- Fixed manual clipboard card updates from YouTube playback so generated audio and images use mpv's resolved stream URLs instead of the YouTube page URL.

changes/fix-youtube-sidebar-primary-cues.md

@@ -1,4 +0,0 @@
-type: fixed
-area: youtube
-
-- Downloaded selected YouTube primary subtitles to temporary local files so the primary bar and sidebar read the same subtitle source, with temp-file cleanup on reload and quit. Suppressed stale failure notifications by re-checking live mpv subtitle state before reporting primary subtitle load failures.

changes/jellyfin-discovery.md

@@ -0,0 +1,6 @@
+type: fixed
+area: jellyfin
+
+- Fixed Jellyfin discovery playback: the active item is no longer reloaded on startup, paused mpv is no longer misreported as playing, startup unpause no longer repeats after a manual pause or `y-t` toggle, duplicate ready signals no longer re-show the overlay, delayed Japanese subtitle selection is handled correctly, later-loading foreign tracks no longer steal the active Japanese track, and long-lived sidebar ffmpeg extractors no longer run against stream URLs.
+- Fixed discovery resume when a remote play command sends `StartPositionTicks: 0` despite saved progress on the item.
+- Kept Jellyfin picker library discovery working when the app log level is above info.

changes/jellyfin-picker-log-level.md

@@ -1,4 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Kept Jellyfin picker library discovery working when the running app log level is above info.

changes/jellyfin-remote.md

@@ -0,0 +1,8 @@
+type: fixed
+area: jellyfin
+
+- Keep the discovery tray checkbox in sync on Linux after tray, CLI, or startup remote-session changes, and restart stale discovery sessions when the server no longer lists the SubMiner cast target.
+- Fixed remote controller visibility and progress sync for mpv/SubMiner seek jumps, stopped sessions, startup path changes, and Linux websocket reconnect windows.
+- Kept Play and Resume distinct: Play starts from the beginning while Resume starts at the saved position, and final progress reports reuse SubMiner's last known position when mpv resets during stop.
+- Derived cast device identity from the OS hostname and always report the client as SubMiner, ignoring legacy configurable identity fields so multiple installs no longer share a remote-session identity.
+- Fixed the Windows setup login flow with an IPC bridge, immediate progress feedback, and a timeout with an inline error for unreachable servers.

changes/jellyfin-subtitles-overlay.md

@@ -0,0 +1,6 @@
+type: fixed
+area: jellyfin
+
+- Show the visible subtitle overlay automatically during Jellyfin playback so `subtitleStyle` appearance applies, and inject the bundled mpv plugin when SubMiner auto-launches mpv so mpv-side keybindings work without overlay focus.
+- Made the `y-t` overlay toggle reliable and sticky across stream redirects that change mpv's path, re-arming managed subtitle defaults on redirect so Japanese primary subtitles load, collapsing duplicate toggle events on Hyprland, and keeping passive Linux/Hyprland overlay shows from stealing keyboard focus from mpv.
+- Improved subtitle timing by preferring default embedded streams over external sidecars, stripping Jellyfin's server-selected stream from playback URLs, suppressing mpv auto-selection while SubMiner stages managed tracks, correcting clear Japanese-vs-English cue offsets, and restoring per-stream subtitle delay shifts. Track selection tolerates transient `track-list` read failures and numeric string track IDs on Linux.

changes/jellyfin-visible-overlay.md

@@ -1,5 +0,0 @@
-type: fixed
-area: jellyfin
-
-- Showed the visible subtitle overlay automatically during Jellyfin playback so configured `subtitleStyle` appearance applies to Jellyfin subtitles.
-- Injected the bundled mpv plugin when SubMiner auto-launches mpv for Jellyfin playback, restoring mpv-side keybindings without needing overlay focus.

changes/known-word-color-config.md

@@ -1,4 +0,0 @@
-type: changed
-area: config
-
-- Config: Moved known-word and N+1 annotation colors to `subtitleStyle.knownWordColor` and `subtitleStyle.nPlusOneColor`; legacy Anki color keys are still accepted with warnings.

changes/launcher-fixes.md

@@ -0,0 +1,8 @@
+type: fixed
+area: launcher
+
+- Launcher-opened videos reuse an already-running background SubMiner instance, reapply preferred subtitles on warm launches, and close launcher-owned tray apps after playback ends.
+- Videos stay paused when attaching to a running background app until subtitle priming and tokenization readiness complete, with mpv plugin subtitle auto-selection moved to pre-load so launch-time choices are not reset.
+- `subminer settings` on macOS no longer emits Electron menu diagnostics and exits cleanly when the window is closed.
+- `subminer app` on Linux returns control to the terminal immediately, and Linux first-run launcher installs build with a valid Bun shebang.
+- `subminer app --setup` opens the setup flow when SubMiner is already running in the background.

changes/launcher-mpv.md

@@ -0,0 +1,6 @@
+type: added
+area: launcher
+
+- Added `subminer --version` / `subminer -v` to print the installed app version.
+- Added `mpv.profile` config and Settings support for passing an mpv profile to SubMiner-managed mpv launches.
+- Made bundled mpv plugin startup options configurable from SubMiner config.

changes/launcher-version-flag.md

@@ -1,4 +0,0 @@
-type: added
-area: launcher
-
-- Added `subminer --version` and `subminer -v` to print the installed SubMiner app version.

changes/linux-direct-launcher-update.md

@@ -1,5 +0,0 @@
-type: fixed
-area: updater
-
-- Made Linux `subminer -u` perform release updates from the launcher, independent of any running tray app instance, while reporting `up to date` without downloading assets when the latest release is not newer.
-- Limited support asset updates to the Linux rofi theme.

changes/linux-launcher-shim.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- Fixed Linux first-run launcher installs by building the packaged launcher with a valid Bun shebang.

changes/linux-updater-curl-fetch.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Fixed Linux automatic update checks to avoid Electron networking, preventing native Electron network-service crashes during video startup.

changes/linux-updater-error-event.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Stopped Linux tray update checks from invoking the native Electron updater, using GitHub release metadata/assets instead so checks do not crash the tray app.

changes/log-export.md

@@ -0,0 +1,4 @@
+type: added
+area: logs
+
+- Add sanitized log ZIP exports from the tray menu and `subminer logs -e`, with home-directory usernames redacted from exported log contents.

changes/logging.md

@@ -0,0 +1,7 @@
+type: fixed
+area: logging
+
+- Forward SubMiner `logging.level` into launcher-started and Windows shortcut-started mpv sessions, covering mpv log verbosity, plugin script logging, and plugin-launched app logging.
+- Added numeric `logging.rotation` (default 7 days of retained daily app, launcher, and mpv logs) and `logging.files` toggles per component, with mpv logs disabled by default unless explicitly enabled for debugging.
+- Added Windows mpv launch, IPC socket, subtitle track, and Yomitan/dictionary diagnostics, including expected/active IPC socket values when plugin auto-start skips on a socket mismatch.
+- Stop repeated mpv IPC socket warning spam while the app waits in the background for mpv to recreate the socket.

changes/macos-config-window-exit.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- macOS `subminer settings` launches now exit cleanly after the settings window is closed, returning control to the terminal without requiring Ctrl+C.

changes/macos-local-bin-launcher.md

@@ -1,4 +0,0 @@
-type: fixed
-area: setup
-
-- First-run setup now recognizes installed macOS launchers in Homebrew or user PATH dirs, while manual setup installs avoid Homebrew-owned directories.

changes/macos-manual-update-required.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Fixed macOS tray update checks for builds that cannot install native app updates, so newer stable or prerelease GitHub releases are reported instead of incorrectly saying the current build is up to date.

changes/macos-overlay-focus-handoff.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Kept the macOS visible overlay stable when clicking from the overlay back into mpv.

changes/macos-update-dialog-activation.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- macOS update dialogs triggered by `subminer -u` now reliably appear in the foreground. SubMiner now shows the dock icon and activates itself via `osascript` (LaunchServices) before opening the modal alert; `app.focus({ steal: true })` alone was unreliable when SubMiner was reached through single-instance forwarding from the CLI-spawned child, leaving the dialog stranded behind other apps with a bouncing dock icon.

changes/macos-update-dialog-focus.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Bring macOS update dialogs to the front when `subminer --update` is run from the launcher.

changes/macos-updater-curl-fetch.md

@@ -1,4 +0,0 @@
-type: fixed
-area: updater
-
-- Routed macOS supplemental GitHub release lookups through `/usr/bin/curl` instead of Electron `net.fetch`, eliminating the last Electron-networking path from background update checks and avoiding the network-service crashes seen in earlier prereleases.

changes/macos-updater-zip-collision.md

@@ -1,4 +0,0 @@
-type: fixed
-area: release
-
-- Fixed macOS updater metadata mismatches by giving macOS and Windows ZIP release assets distinct build-time filenames.

changes/make-install-fresh-appimage.md

@@ -1,4 +0,0 @@
-type: fixed
-area: build
-
-- Fixed one-shot `make clean build install` flows so install picks up the AppImage built earlier in the same make invocation.

changes/mpv-config-unified.md

@@ -1,4 +0,0 @@
-type: added
-area: launcher
-
-- Managed bundled mpv plugin startup options from SubMiner config.

changes/mpv-profile-config.md

@@ -1,4 +0,0 @@
-type: added
-area: launcher
-
-- Added `mpv.profile` config and settings support for passing an mpv profile to SubMiner-managed mpv launches.

changes/mpv-session-shortcuts.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Wired configured session shortcuts, including `stats.markWatchedKey`, through mpv so custom add/remove changes work while mpv has focus.

changes/native-updater-crash.md

@@ -1,6 +0,0 @@
-type: fixed
-area: updates
-
-- Restored the standard macOS `electron-updater`/Squirrel update path and routed supplemental GitHub updater requests through Electron networking instead of Node fetch.
-- macOS update checks now skip local build-output apps outside Applications before touching Squirrel, and macOS tray checks no longer perform the supplemental GitHub asset lookup.
-- macOS `electron-updater` metadata and full ZIP downloads now use `/usr/bin/curl` under the hood to avoid the Electron network crash seen during tray update checks while preserving Squirrel installation.

changes/note-fields-default-note-type.md

@@ -1,4 +0,0 @@
-type: fixed
-area: config
-
-- Defaulted the note-fields note type picker to the configured Anki deck's note type when available, then exact `Kiku`, then exact `Lapis`, otherwise leaving it blank for manual selection.

changes/nplusone-defaults.md

@@ -0,0 +1,5 @@
+type: changed
+area: config
+
+- `ankiConnect.nPlusOne.enabled` is no longer implicitly set to `true` when known-word highlighting is enabled; existing configs that already had N+1 highlighting keep it, but new configs leave it disabled unless `ankiConnect.nPlusOne.enabled` is set explicitly.
+- Updated known-word cache docs and examples to recommend expression/word fields and removed legacy-option references from user-facing config docs.

changes/nplusone-known-word-compat.md

@@ -1,4 +0,0 @@
-type: changed
-area: config
-
-- Config: Preserved N+1 subtitle highlighting for existing configs that already enabled known-word highlighting, while keeping N+1 disabled by default for new configs unless `ankiConnect.nPlusOne.enabled` is set.

changes/overlay-lifecycle.md

@@ -0,0 +1,8 @@
+type: fixed
+area: overlay
+
+- Primed the first startup subtitle before autoplay resumes so the overlay renders text before video playback begins.
+- Kept the visible overlay and subtitle stream alive after restarting SubMiner from the mpv `y-r` shortcut, with correct Linux bounds reapplication and user-paused playback preserved through readiness gates.
+- Fixed managed mpv startup so launcher-owned videos quit SubMiner when playback ends while background/tray sessions stay alive, with pause-until-ready waiting for overlay and tokenization readiness.
+- Fixed the subtitle sync modal on macOS so it no longer flashes and hides on the first attempt or leaves stale state after syncing.
+- Fixed Windows managed mpv launches from a background instance so the warm app receives the start command, retargets the new mpv socket, binds to the player window, and receives startup overlay options.

changes/overlay-linux.md

@@ -0,0 +1,7 @@
+type: fixed
+area: overlay
+
+- Refreshed overlay placement after leaving mpv fullscreen so the visible overlay stays aligned to the player on Hyprland.
+- Kept the visible overlay stacked above mpv after mpv regains focus from clicks or overlay movement, and suspended it while the in-player stats window is open, restoring it mouse-passive afterward.
+- Promoted SubMiner and Yomitan settings windows above the subtitle overlay on Hyprland instead of opening behind it, without hiding subtitles.
+- Hid the visible overlay as soon as the character dictionary modal opens, including while AniList lookup is loading or returns no results.

changes/overlay-macos.md

@@ -0,0 +1,7 @@
+type: fixed
+area: overlay
+
+- Hid the macOS visible overlay when mpv loses focus, is minimized, or is no longer the foreground target so other apps and Spaces are not covered, treating the frontmost mpv app as the focus signal.
+- Kept the overlay stable through transient window-tracking misses, when mpv remains frontmost but window geometry temporarily disappears from macOS APIs, and when clicking from the overlay back into mpv.
+- Kept the overlay correctly layered during stats mouse passthrough, opened the stats overlay inactive so it appears over fullscreen mpv without switching Spaces, and fixed passthrough so mpv controls stay clickable before hovering a subtitle bar.
+- Reduced window-tracker background work by preferring the compiled helper and slowing polls while mpv is stably focused.

changes/overlay-restart-visible.md

@@ -1,4 +0,0 @@
-type: fixed
-area: overlay
-
-- Kept the visible overlay and subtitle stream alive after restarting SubMiner from the mpv `y-r` shortcut by transporting Linux AppImage control args safely, restoring mpv subtitle visibility during shutdown, snapshotting subtitles before overlay suppression resumes, reapplying Linux overlay bounds after the restarted window maps, allowing Hyprland to resize the visible overlay window, and preserving user-paused playback while readiness gates clear.

changes/overlay-yomitan-sidebar.md

@@ -0,0 +1,6 @@
+type: fixed
+area: overlay
+
+- Kept playback paused for Yomitan lookup popups opened from the subtitle sidebar when popup auto-pause is enabled.
+- Fixed Yomitan popups not opening when playback/overlay startup races the Yomitan extension load.
+- Fixed subtitle sidebar mining so Yomitan-enriched cards use audio and images from the clicked sidebar line instead of the current primary subtitle line.

changes/packaging.md

@@ -0,0 +1,5 @@
+type: fixed
+area: release
+
+- Fixed macOS packaging so the compiled mpv window helper is built into `dist/scripts` and bundled, preventing the overlay from falling back to slow Swift source startup, and removed a stale Windows helper resource entry that produced harmless missing-file warnings.
+- Fixed one-shot `make clean build install` flows so install picks up the AppImage built earlier in the same make invocation.

changes/prerelease-notes-reuse.md

@@ -1,4 +0,0 @@
-type: changed
-area: release
-
-- Prerelease note generation now reuses existing reviewed prerelease notes and asks Claude to merge only new fragment material, while `make clean` preserves `release/prerelease-notes.md`.

changes/primary-visible-yomitan-popup.md

@@ -0,0 +1,4 @@
+type: added
+area: config
+
+- Added `subtitleStyle.primaryVisibleOnYomitanPopup` to keep hover-mode primary subtitles visible while a Yomitan popup is open.

changes/release-notes-tooling.md

@@ -0,0 +1,5 @@
+type: internal
+area: release
+
+- Release-note polishing treats pending fragments and reviewed prerelease notes as a cumulative final outcome, collapsing prerelease-only fixes or breakages into the final user-facing change.
+- Prerelease note generation reuses existing reviewed notes and merges only new fragment material, and `make clean` preserves `release/prerelease-notes.md`.

changes/settings-window.md

@@ -0,0 +1,8 @@
+type: added
+area: config
+
+- Added a dedicated Settings window via `subminer --settings` or `subminer settings`, organized into Appearance, Behavior, Anki, Input, and Integration sections with click-to-learn keybinding controls (including the AniSkip button key) and AnkiConnect-backed deck, field, and note-type pickers.
+- Expanded live reload so Settings saves apply immediately for stats keys, logging level, Jimaku, Subsync, YouTube language defaults, Anki field mappings, sentence card model, and selected annotation/runtime options.
+- Settings search works across all categories, narrows on multi-word terms, and hides settings owned by richer editors.
+- The note-fields note type picker defaults to the configured Anki deck's note type, then exact `Kiku`, then exact `Lapis`, leaving it blank for manual selection otherwise.
+- AI and translation settings remain config-file only.

changes/setup-background-command.md

@@ -1,4 +0,0 @@
-type: fixed
-area: launcher
-
-- Fixed `subminer app --setup` so it opens the setup flow when SubMiner is already running in the background.

changes/setup-finish-quit.md

@@ -1,4 +0,0 @@
-type: fixed
-area: setup
-
-- Quit standalone setup app launches after first-run setup finishes, returning the terminal instead of leaving the app process open.