From 006db2d528f333639b9a2602729f6036d730e583 Mon Sep 17 00:00:00 2001
From: sudacode <suda@sudacode.com>
Date: Tue, 10 Feb 2026 19:55:33 -0800
Subject: [PATCH] Document invisible subtitle position edit mode

---
 README.md                        | 1 +
 config.example.jsonc             | 2 ++
 docs/configuration.md            | 7 +++++++
 docs/public/config.example.jsonc | 2 ++
 docs/usage.md                    | 4 ++++
 src/config/definitions.ts        | 4 ++++
 6 files changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 61796bb..4687789 100644
--- a/README.md
+++ b/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
 
diff --git a/config.example.jsonc b/config.example.jsonc
index 2e7ebc2..686d99b 100644
--- a/config.example.jsonc
+++ b/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"
diff --git a/docs/configuration.md b/docs/configuration.md
index d2815b7..fe17875 100644
--- a/docs/configuration.md
+++ b/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
 
diff --git a/docs/public/config.example.jsonc b/docs/public/config.example.jsonc
index 2e7ebc2..686d99b 100644
--- a/docs/public/config.example.jsonc
+++ b/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"
diff --git a/docs/usage.md b/docs/usage.md
index cd63da5..700d699 100644
--- a/docs/usage.md
+++ b/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.
 
diff --git a/src/config/definitions.ts b/src/config/definitions.ts
index 9ddb819..641c96d 100644
--- a/src/config/definitions.ts
+++ b/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",
   },
   {