mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-03-06 19:57:26 -08:00
148 lines
8.4 KiB
Markdown
148 lines
8.4 KiB
Markdown
# 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](https://www.electronjs.org/docs/latest/tutorial/keyboard-shortcuts), for example `"CommandOrControl+Shift+M"`. Use `null` to disable a shortcut.
|
||
|
||
```jsonc
|
||
{
|
||
"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:
|
||
|
||
```jsonc
|
||
{
|
||
"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](/configuration#hot-reload-behavior) — changes take effect without restarting SubMiner.
|