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