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+I	Toggle invisible overlay	shortcuts.toggleInvisibleOverlayGlobal
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
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
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.

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

Invisible Subtitle Position Edit Mode

Enter edit mode to fine-tune invisible overlay alignment with mpv's native subtitles.

Shortcut	Action
Ctrl/Cmd+Shift+P	Toggle position edit mode
ArrowKeys or hjkl	Nudge position by 1 px
Shift+Arrow	Nudge position by 4 px
Enter or Ctrl+S	Save position and exit edit mode
Esc	Cancel and discard changes

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-i	Toggle invisible overlay
y-I	Show invisible overlay
y-u	Hide invisible overlay
y-o	Open Yomitan settings
y-r	Restart overlay
y-c	Check overlay status
y-d	Toggle overlay DevTools (dev/debug use)

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",
    "toggleInvisibleOverlayGlobal": "Alt+Shift+I",
    "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.