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 on leave).

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.