Keyboard shortcuts
Every key SubMiner responds to, with its default binding. Ctrl/Cmd means Ctrl on Windows and Linux and Cmd on macOS (CommandOrControl in config).
Shortcuts work when the overlay has focus. With the mpv plugin, shortcuts.* and keybindings entries also work while mpv has focus. If a key does nothing, click the video once. Set any shortcut to null to disable it. Changes to shortcuts, keybindings, and subtitleSidebar apply without a restart.
Global
| Shortcut | Action | Config key |
|---|---|---|
Alt+Shift+O | Toggle visible overlay | shortcuts.toggleVisibleOverlayGlobal |
Alt+Shift+Y | Open active dictionary settings | Fixed |
Alt+Shift+Y opens Yomitan or Hachidori settings, whichever backend is running. It is registered with the OS and works from any app. If another app already uses it, SubMiner cannot take it and you cannot rebind it.
Mining
| Shortcut | Action | Config key |
|---|---|---|
Ctrl/Cmd+S | Mine current line as a sentence card | shortcuts.mineSentence |
Ctrl/Cmd+Shift+S | Mine several lines as one sentence card | shortcuts.mineSentenceMultiple |
Ctrl/Cmd+C | Copy current line | shortcuts.copySubtitle |
Ctrl/Cmd+Shift+C | Copy several lines | shortcuts.copySubtitleMultiple |
Ctrl/Cmd+V | Update last-added card from the clipboard | shortcuts.updateLastCardFromClipboard |
Ctrl/Cmd+G | Run the field grouping check on the last-added card | shortcuts.triggerFieldGrouping |
Ctrl/Cmd+Shift+A | Mark last-added card as an audio card | shortcuts.markAudioCard |
After a multi-line shortcut, press 1 to 9 for how many lines to combine, counting back from and including the current line. The prompt closes after shortcuts.multiCopyTimeoutMs.
When text is selected in the subtitle sidebar, Ctrl/Cmd+C copies that selection instead.
Playback
These are the default keybindings entries. Remap or disable them in the keybindings array.
| Shortcut | Action |
|---|---|
Space | Pause or resume |
F | Toggle fullscreen |
J | Cycle primary subtitle track |
Shift+J | Cycle secondary subtitle track |
ArrowRight | Seek forward 5 seconds |
ArrowLeft | Seek back 5 seconds |
ArrowUp | Seek forward 60 seconds |
ArrowDown | Seek back 60 seconds |
Shift+H | Jump to previous subtitle |
Shift+L | Jump to next subtitle |
Ctrl+Shift+Left | Shift subtitle delay to the previous cue |
Ctrl+Shift+Right | Shift subtitle delay to the next cue |
Z | Subtitle delay -100 ms |
Shift+Z | Subtitle delay +100 ms |
X | Subtitle delay +100 ms |
Ctrl+Shift+H | Replay current subtitle, then pause |
Ctrl+Shift+L | Play next subtitle, then pause |
Ctrl+Alt+P | Open playlist browser |
Ctrl+Alt+C | Open YouTube subtitle picker |
Q | Quit mpv |
Ctrl+W | Quit mpv |
Built into the overlay, not configurable:
| Input | Action |
|---|---|
V | Cycle primary subtitle bar: hidden, visible, hover |
C (keyboard-only mode) | Move by word or by character |
| Right-click | Pause or resume (outside the subtitle area) |
| Right-click + drag | Move the subtitles |
| Drop files on the overlay | Replace the mpv playlist |
Shift + drop files | Append to the mpv playlist |
Overlay features
| Shortcut | Action | Config key |
|---|---|---|
Ctrl/Cmd+Shift+V | Cycle secondary subtitle bar: hidden, visible, hover | shortcuts.toggleSecondarySub |
Ctrl/Cmd+Shift+O | Open runtime options | shortcuts.openRuntimeOptions |
Ctrl/Cmd+/ | Open session help | shortcuts.openSessionHelp |
Ctrl/Cmd+D | Open character dictionary manager | shortcuts.openCharacterDictionaryManager |
Ctrl/Cmd+N | Toggle notification history | shortcuts.toggleNotificationHistory |
Ctrl/Cmd+A | Append the video path on the clipboard to the playlist | shortcuts.appendClipboardVideoToQueue |
Ctrl+Shift+J | Open Jimaku subtitle search | shortcuts.openJimaku |
Ctrl+Shift+T | Open TsukiHime subtitle search | shortcuts.openTsukihime |
Ctrl+Shift+G | Open Japanese subtitle generation | shortcuts.openSubtitleGeneration |
Ctrl+Alt+S | Open subtitle sync (subsync) | shortcuts.triggerSubsync |
g then s | Pick primary and secondary subtitles (when enabled) | shortcuts.openSubtitleSelection |
\ | Toggle subtitle sidebar | subtitleSidebar.toggleKey |
` | Toggle stats overlay | stats.toggleKey |
W | Mark video watched and play the next one in the queue | stats.markWatchedKey |
Alt+C | Open controller setup and remapping | shortcuts.openControllerSelect |
Alt+Shift+C | Open controller debug view | shortcuts.openControllerDebug |
While a video is playing, session help can also run commands: highlight a row with the arrow keys or the mouse, then press Enter or double-click it. Fixed overlay controls, global shortcuts, y chords, the multi-line copy and mine actions, Open session help, and the color legend are reference only. Help opened from the tray with no video loaded is read-only.
The sidebar key has a separate mpv-side binding, shortcuts.toggleSubtitleSidebar. The sidebar only opens when SubMiner has parsed the active subtitle file. In the sidebar, Enter seeks to the focused line.
The subtitle picker (g then s) is off until you turn it on in Settings, Behavior, Subtitle Selection. Press the second key within one second. If g already has an action in SubMiner or mpv, the sequence is disabled and a warning is shown. See subtitle selection.
mpv plugin keys
Press y, then the second key.
| Keys | Action |
|---|---|
y-y | Open the SubMiner menu |
y-s | Start the overlay |
y-S | Stop the overlay |
y-t | Toggle the visible overlay |
y-o | Open active dictionary settings |
y-r | Restart the overlay |
y-c | Show overlay status |
y-h | Open session help |
v | Cycle primary subtitle bar |
The plugin's v replaces mpv's own subtitle visibility toggle. When the overlay has focus, y then d toggles DevTools.
Customizing
shortcuts.* values are Electron accelerator strings.
{
"shortcuts": {
"mineSentence": "CommandOrControl+S",
"openJimaku": null, // disabled
},
}keybindings entries map a key to an mpv command. They are merged with the defaults above. Set command to null to disable a default.
{
"keybindings": [
{ "key": "m", "command": ["cycle", "mute"] },
{ "key": "MBTN_BACK", "command": ["sub-seek", -1] },
{ "key": "Ctrl+WHEEL_UP", "command": ["add", "sub-scale", 0.1] },
{ "key": "Space", "command": null },
],
}To run a plugin action, use ["__plugin-action:<plugin id>/<action>"] as the command.
Mouse button names are MBTN_LEFT, MBTN_MID, MBTN_RIGHT, MBTN_BACK, and MBTN_FORWARD. Scroll wheel names are WHEEL_UP, WHEEL_DOWN, WHEEL_LEFT, and WHEEL_RIGHT. See keybindings and shortcuts configuration in the config reference.
Automatic mpv bindings
The overlay reads single-key, mouse button, and scroll wheel bindings from the running mpv (input.conf, mpv defaults, and scripts). If SubMiner does not handle the input, it passes it to mpv, so mpv's defaults like double-click for fullscreen and the wheel for volume work over the overlay. SubMiner shortcuts and keybindings entries win, including ones set to null, and right-click always pauses. Keys and clicks are not forwarded while you type in a text field, use an overlay menu, or have a Yomitan popup open, and clicks on subtitles or overlay controls stay with SubMiner. Scrolling over an overlay menu, the subtitle sidebar, or notification history scrolls that panel instead.
Keypad and media keys, key sequences, and mouse movement are not imported. Bindings imported this way do not appear in session help. If you add an mpv binding while SubMiner runs, refocus the overlay to pick it up.