6.8 KiB
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 |
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",
"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.