SubMiner/docs/shortcuts.md

Keyboard Shortcuts

All shortcuts are configurable in config.jsonc under shortcuts and keybindings. Set any shortcut to null to disable it.

Global Shortcuts

These work system-wide regardless of which window has focus.

Shortcut	Action	Configurable
Alt+Shift+O	Toggle visible overlay	shortcuts.toggleVisibleOverlayGlobal
Alt+Shift+Y	Open Yomitan settings	Fixed (not configurable)

::: tip Global shortcuts are registered with the OS. If they conflict with another application, update them in shortcuts config and restart SubMiner. :::

Mining Shortcuts

These work when the overlay window has focus.

Shortcut	Action	Config key
Ctrl/Cmd+S	Mine current subtitle as sentence card	shortcuts.mineSentence
Ctrl/Cmd+Shift+S	Mine multiple lines (press 1–9 to select count)	shortcuts.mineSentenceMultiple
Ctrl/Cmd+C	Copy current subtitle text	shortcuts.copySubtitle
Ctrl/Cmd+Shift+C	Copy multiple lines (press 1–9 to select count)	shortcuts.copySubtitleMultiple
Ctrl/Cmd+V	Update last Anki card from clipboard text	shortcuts.updateLastCardFromClipboard
Ctrl/Cmd+G	Trigger field grouping (Kiku merge check)	shortcuts.triggerFieldGrouping
Ctrl/Cmd+Shift+A	Mark last card as audio card	shortcuts.markAudioCard

The multi-line shortcuts open a digit selector with a 3-second timeout (shortcuts.multiCopyTimeoutMs). Press 1–9 to select how many recent subtitle lines to combine.

Overlay Controls

These control playback and subtitle display. They require overlay window focus.

Shortcut	Action
Space	Toggle mpv pause
J	Cycle primary subtitle track
Shift+J	Cycle secondary subtitle track
ArrowRight	Seek forward 5 seconds
ArrowLeft	Seek backward 5 seconds
ArrowUp	Seek forward 60 seconds
ArrowDown	Seek backward 60 seconds
Shift+H	Jump to previous subtitle
Shift+L	Jump to next subtitle
Shift+[	Shift subtitle delay to previous subtitle cue
Shift+]	Shift subtitle delay to next subtitle cue
Ctrl+Shift+H	Replay current subtitle (play to end, then pause)
Ctrl+Shift+L	Play next subtitle (jump, play to end, then pause)
Q	Quit mpv
Ctrl+W	Quit mpv
Right-click	Toggle pause (outside subtitle area)
Right-click + drag	Reposition subtitles (on subtitle area)
Ctrl/Cmd+A	Append clipboard video path to mpv playlist

These keybindings can be overridden or disabled via the keybindings config array.

Mouse-hover playback behavior is configured separately from shortcuts: subtitleStyle.autoPauseVideoOnHover defaults to true (pause on subtitle hover; resume after leaving subtitle area). Optional popup behavior: set subtitleStyle.autoPauseVideoOnYomitanPopup to true to keep playback paused while Yomitan popup is open.

When a Yomitan popup is open, SubMiner also provides popup control shortcuts:

Shortcut	Action
J	Scroll definitions down
K	Scroll definitions up
ArrowDown	Scroll definitions down
ArrowUp	Scroll definitions up
M	Mine/add selected term
P	Play selected term audio
[	Play previous available audio (selected source)
]	Play next available audio (selected source)

Keyboard-Driven Lookup Mode

These shortcuts are fixed (not configurable) and require overlay focus.

Shortcut	Action
Ctrl/Cmd+Shift+Y	Toggle keyboard-driven token selection mode on/off
Ctrl/Cmd+Y	Toggle lookup popup for selected token (open when closed, close when open)
ArrowLeft/Right, H, or L	Move selected token (previous/next); if lookup is open, refresh definition for the new token

Keyboard-driven mode draws a selection outline around the active token. Use Ctrl/Cmd+Y to open or close lookup for that token. While the popup is open, popup-local controls still work from the overlay (J/K, ArrowUp/ArrowDown, M, P, [, ]) and focus is forced back to the overlay so token navigation can continue without clicking subtitle text again. Moving left/right past the start or end of the line jumps to the previous or next subtitle line and keeps playback paused if it was already paused.

Subtitle & Feature Shortcuts

Shortcut	Action	Config key
Ctrl/Cmd+Shift+V	Cycle secondary subtitle mode (hidden → visible → hover)	shortcuts.toggleSecondarySub
Ctrl/Cmd+Shift+O	Open runtime options palette	shortcuts.openRuntimeOptions
Ctrl+Shift+J	Open Jimaku subtitle search modal	shortcuts.openJimaku
Ctrl+Alt+S	Open subtitle sync (subsync) modal	shortcuts.triggerSubsync

MPV Plugin Chords

When the mpv plugin is installed, all commands use a y chord prefix — press y, then the second key within 1 second.

Chord	Action
y-y	Open SubMiner menu (OSD)
y-s	Start overlay
y-S	Stop overlay
y-t	Toggle visible overlay
y-o	Open Yomitan settings
y-r	Restart overlay
y-c	Check overlay status

When the overlay has focus, press y then d to toggle DevTools (debugging helper).

Drag-and-Drop

Gesture	Action
Drop file(s) onto overlay	Replace current mpv playlist with dropped files
Shift + drop file(s)	Append all dropped files to current mpv playlist

Customizing Shortcuts

All shortcuts.* keys accept Electron accelerator strings, for example "CommandOrControl+Shift+M". Use null to disable a shortcut.

{
  "shortcuts": {
    "mineSentence": "CommandOrControl+S",
    "copySubtitle": "CommandOrControl+C",
    "toggleVisibleOverlayGlobal": "Alt+Shift+O",
    "openJimaku": null, // disabled
  },
}

The keybindings array overrides or extends the overlay's built-in key handling for mpv commands:

{
  "keybindings": [
    { "key": "f", "command": ["cycle", "fullscreen"] },
    { "key": "m", "command": ["cycle", "mute"] },
    { "key": "Space", "command": null }, // disable default Space → pause
  ],
}

Both shortcuts and keybindings are hot-reloadable — changes take effect without restarting SubMiner.