Document invisible subtitle position edit mode

README.md

@@ -13,6 +13,7 @@ An all-in-one sentence mining overlay for MPV with AnkiConnect and dictionary (Y
 - Integrated texthooker-ui server for use with Yomitan
 - Integrated websocket server (if [mpv_websocket](https://github.com/kuroahna/mpv_websocket) is not found) to send lines to the texthooker
 - AnkiConnect integration for automatic card creation with media (audio/image)
+- Invisible subtitle position edit mode (`Ctrl/Cmd+Shift+P`, arrow keys to adjust, `Enter`/`Ctrl+S` save, `Esc` cancel)
 
 ## Demo
 

config.example.jsonc

@@ -122,6 +122,8 @@
   // ==========================================
   // Invisible Overlay
   // Startup behavior for the invisible interactive subtitle mining layer.
+  // Invisible subtitle position edit mode: Ctrl/Cmd+Shift+P to toggle, arrow keys to move, Enter or Ctrl/Cmd+S to save, Esc to cancel.
+  // This edit-mode shortcut is fixed and is not currently configurable.
   // ==========================================
   "invisibleOverlay": {
     "startupVisibility": "platform-default"

docs/configuration.md

@@ -278,6 +278,13 @@ SubMiner includes a second subtitle mining layer that can be visually invisible
 2. `"visible"`: always shown on startup.
 3. `"hidden"`: always hidden on startup.
 
+Invisible subtitle positioning can be adjusted directly in the invisible layer:
+
+- `Ctrl/Cmd+Shift+P` toggles position edit mode.
+- Use arrow keys to move the invisible subtitle text.
+- Press `Enter` or `Ctrl/Cmd+S` to save, or `Esc` to cancel.
+- This edit-mode shortcut is fixed (not currently configurable in `shortcuts`/`keybindings`).
+
 
 ### Jimaku
 

docs/public/config.example.jsonc

@@ -122,6 +122,8 @@
   // ==========================================
   // Invisible Overlay
   // Startup behavior for the invisible interactive subtitle mining layer.
+  // Invisible subtitle position edit mode: Ctrl/Cmd+Shift+P to toggle, arrow keys to move, Enter or Ctrl/Cmd+S to save, Esc to cancel.
+  // This edit-mode shortcut is fixed and is not currently configurable.
   // ==========================================
   "invisibleOverlay": {
     "startupVisibility": "platform-default"

docs/usage.md

@@ -112,6 +112,10 @@ Notes:
 | `Ctrl+W`             | Quit mpv                                           |
 | `Right-click`        | Toggle MPV pause (outside subtitle area)           |
 | `Right-click + drag` | Move subtitle position (on subtitle)               |
+| `Ctrl/Cmd+Shift+P`   | Toggle invisible subtitle position edit mode       |
+| `Arrow keys`         | Move invisible subtitles while edit mode is active |
+| `Enter` / `Ctrl+S`   | Save invisible subtitle position in edit mode      |
+| `Esc`                | Cancel invisible subtitle position edit mode       |
 
 These keybindings only work when the overlay window has focus. See [Configuration](/configuration) for customization.
 

src/config/definitions.ts

@@ -389,6 +389,10 @@ export const CONFIG_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
     description: [
       "Startup behavior for the invisible interactive subtitle mining layer.",
     ],
+    notes: [
+      "Invisible subtitle position edit mode: Ctrl/Cmd+Shift+P to toggle, arrow keys to move, Enter or Ctrl/Cmd+S to save, Esc to cancel.",
+      "This edit-mode shortcut is fixed and is not currently configurable.",
+    ],
     key: "invisibleOverlay",
   },
   {