feat: allow lower-level paste keycode config

Author: goodroot

README.md

@@ -598,7 +598,7 @@ Toggle this behavior in `~/.config/hyprwhspr/config.json`:
 
 ```jsonc
 {
-    "paste_mode": "ctrl_shift"   // "ctrl_shift" | "ctrl" | "super" (default: "ctrl_shift")
+    "paste_mode": "ctrl_shift",  // "ctrl_shift" | "ctrl" | "super" (default: "ctrl_shift")
 }
 ```
 
@@ -610,6 +610,24 @@ Toggle this behavior in `~/.config/hyprwhspr/config.json`:
 
 - **`"super"`** — Sends Super+V. Maybe finicky.
 
+**Non-QWERTY layouts (bepo, dvorak, etc.)**
+
+`ydotool` sends physical Linux keycodes, so `Ctrl+KEY_V` might not be `Ctrl+v` on your layout. 
+
+Quick way to fix it on Wayland (no arithmetic):
+
+- Run `wev` in terminal
+- Press the key that types `v` on your layout
+- Copy the printed `keycode` into `paste_keycode_wev`
+
+```jsonc
+{
+    "paste_keycode_wev": 55 // `wev` keycode for the key that types 'v' on your layout
+}
+```
+
+Advanced (if you already know the Linux evdev keycode): set `paste_keycode` directly.
+
 **Auto-submit** - automatically press Enter after pasting:
 
 > aka Dictation YOLO

lib/src/config_manager.py

@@ -45,6 +45,14 @@ def __init__(self):
             # Values: "super" | "ctrl_shift" | "ctrl"
             # Default "ctrl_shift" for flexible unix-y primitive
             'paste_mode': 'ctrl_shift',
+            # Wayland/XKB keycode as printed by `wev` for the key that types 'v'.
+            # If set, hyprwhspr will convert it to Linux evdev by subtracting 8.
+            # This avoids users having to do the math themselves.
+            'paste_keycode_wev': None,
+            # ydotool sends Linux evdev keycodes (physical keys), not keysyms/characters.
+            # Default 47 = KEY_V (works on QWERTY; on other layouts set this to the keycode
+            # for the physical key that produces 'v' on your layout).
+            'paste_keycode': 47,
             # Back-compat for older configs (used only if paste_mode is absent):
             'shift_paste': True,  # true = Ctrl+Shift+V, false = Ctrl+V
             # Transcription backend settings

lib/src/text_injector.py

@@ -20,6 +20,8 @@
 
 pyperclip = require_package('pyperclip')
 
+DEFAULT_PASTE_KEYCODE = 47  # Linux evdev KEY_V on QWERTY
+
 
 class TextInjector:
     """Handles injecting text into focused applications"""
@@ -42,6 +44,37 @@ def _check_ydotool(self) -> bool:
         except Exception:
             return False
 
+    def _get_paste_keycode(self) -> int:
+        """
+        Get the Linux evdev keycode used for the 'V' part of paste chords.
+
+        ydotool's `key` command sends raw keycodes (physical keys). On non-QWERTY
+        layouts, KEY_V (47) may not map to a keysym 'v', so Ctrl+KEY_V won't paste.
+        Users can set either:
+        - `paste_keycode_wev`: the Wayland/XKB keycode printed by `wev` (we subtract 8)
+        - `paste_keycode`: the Linux evdev keycode directly (advanced)
+        """
+        keycode = DEFAULT_PASTE_KEYCODE
+        if self.config_manager:
+            wev_keycode = self.config_manager.get_setting('paste_keycode_wev', None)
+            if wev_keycode is not None:
+                try:
+                    # wev reports Wayland/XKB keycodes, which are typically evdev+8
+                    wev_keycode_int = int(wev_keycode)
+                    converted = wev_keycode_int - 8
+                    return converted if converted > 0 else DEFAULT_PASTE_KEYCODE
+                except Exception:
+                    # If parsing fails, fall back to evdev keycode setting
+                    pass
+
+            keycode = self.config_manager.get_setting('paste_keycode', DEFAULT_PASTE_KEYCODE)
+
+        try:
+            keycode_int = int(keycode)
+            return keycode_int if keycode_int > 0 else DEFAULT_PASTE_KEYCODE
+        except Exception:
+            return DEFAULT_PASTE_KEYCODE
+
     def _get_active_window_info(self) -> Optional[Dict[str, Any]]:
         """Get active window info from Hyprland (if available)"""
         try:
@@ -115,35 +148,39 @@ def _send_paste_keys_slow(self, paste_mode: str) -> bool:
         the key sequence when modifiers arrive too quickly.
         """
         try:
+            paste_keycode = self._get_paste_keycode()
+            paste_keycode_pressed = f'{paste_keycode}:1'
+            paste_keycode_released = f'{paste_keycode}:0'
+
             if paste_mode == 'super':
                 # Super+V with delays: Super down, delay, V down, V up, Super up
                 subprocess.run(['ydotool', 'key', '125:1'], capture_output=True, timeout=1)
                 time.sleep(0.015)
-                subprocess.run(['ydotool', 'key', '47:1', '47:0'], capture_output=True, timeout=1)
+                subprocess.run(['ydotool', 'key', paste_keycode_pressed, paste_keycode_released], capture_output=True, timeout=1)
                 time.sleep(0.010)
                 subprocess.run(['ydotool', 'key', '125:0'], capture_output=True, timeout=1)
 
             elif paste_mode == 'ctrl_shift':
                 # Ctrl+Shift+V with delays: mods down, delay, V, delay, mods up
                 subprocess.run(['ydotool', 'key', '29:1', '42:1'], capture_output=True, timeout=1)
                 time.sleep(0.015)
-                subprocess.run(['ydotool', 'key', '47:1', '47:0'], capture_output=True, timeout=1)
+                subprocess.run(['ydotool', 'key', paste_keycode_pressed, paste_keycode_released], capture_output=True, timeout=1)
                 time.sleep(0.010)
                 subprocess.run(['ydotool', 'key', '42:0', '29:0'], capture_output=True, timeout=1)
 
             elif paste_mode == 'ctrl':
                 # Ctrl+V with delays
                 subprocess.run(['ydotool', 'key', '29:1'], capture_output=True, timeout=1)
                 time.sleep(0.015)
-                subprocess.run(['ydotool', 'key', '47:1', '47:0'], capture_output=True, timeout=1)
+                subprocess.run(['ydotool', 'key', paste_keycode_pressed, paste_keycode_released], capture_output=True, timeout=1)
                 time.sleep(0.010)
                 subprocess.run(['ydotool', 'key', '29:0'], capture_output=True, timeout=1)
 
             elif paste_mode == 'alt':
                 # Alt+V with delays
                 subprocess.run(['ydotool', 'key', '56:1'], capture_output=True, timeout=1)
                 time.sleep(0.015)
-                subprocess.run(['ydotool', 'key', '47:1', '47:0'], capture_output=True, timeout=1)
+                subprocess.run(['ydotool', 'key', paste_keycode_pressed, paste_keycode_released], capture_output=True, timeout=1)
                 time.sleep(0.010)
                 subprocess.run(['ydotool', 'key', '56:0'], capture_output=True, timeout=1)
 
@@ -378,10 +415,11 @@ def _inject_via_clipboard_and_hotkey(self, text: str) -> bool:
                     self._clear_stuck_modifiers()
                     time.sleep(0.02)  # Brief settle after clearing modifiers
 
-                #   "super"      -> Super+V      (125:1 47:1 47:0 125:0)
-                #   "ctrl_shift" -> Ctrl+Shift+V (29:1  42:1 47:1 47:0 42:0 29:0)
-                #   "ctrl"       -> Ctrl+V       (29:1  47:1 47:0 29:0)
-                #   "alt"        -> Alt+V        (56:1  47:1 47:0 56:0)
+                paste_keycode = self._get_paste_keycode()
+                paste_keycode_pressed = f'{paste_keycode}:1'
+                paste_keycode_released = f'{paste_keycode}:0'
+
+                # Paste chords are sent as modifiers + a configurable keycode (default KEY_V=47).
                 paste_mode = None
                 if self.config_manager:
                     paste_mode = self.config_manager.get_setting('paste_mode', None)
@@ -412,25 +450,25 @@ def _inject_via_clipboard_and_hotkey(self, text: str) -> bool:
 
                 # Fast path for non-Kitty terminals (original behavior)
                 if paste_mode == 'super':
-                    # LeftMeta (Super) = 125, 'V' = 47
+                    # LeftMeta (Super) = 125
                     result = subprocess.run(
-                        ['ydotool', 'key', '125:1', '47:1', '47:0', '125:0'],
+                        ['ydotool', 'key', '125:1', paste_keycode_pressed, paste_keycode_released, '125:0'],
                         capture_output=True, timeout=5
                     )
                 elif paste_mode == 'ctrl_shift':
                     result = subprocess.run(
-                        ['ydotool', 'key', '29:1', '42:1', '47:1', '47:0', '42:0', '29:0'],
+                        ['ydotool', 'key', '29:1', '42:1', paste_keycode_pressed, paste_keycode_released, '42:0', '29:0'],
                         capture_output=True, timeout=5
                     )
                 elif paste_mode == 'ctrl':
                     result = subprocess.run(
-                        ['ydotool', 'key', '29:1', '47:1', '47:0', '29:0'],
+                        ['ydotool', 'key', '29:1', paste_keycode_pressed, paste_keycode_released, '29:0'],
                         capture_output=True, timeout=5
                     )
                 elif paste_mode == 'alt':
-                    # LeftAlt = 56, 'V' = 47
+                    # LeftAlt = 56
                     result = subprocess.run(
-                        ['ydotool', 'key', '56:1', '47:1', '47:0', '56:0'],
+                        ['ydotool', 'key', '56:1', paste_keycode_pressed, paste_keycode_released, '56:0'],
                         capture_output=True, timeout=5
                     )
                 else:
@@ -440,12 +478,12 @@ def _inject_via_clipboard_and_hotkey(self, text: str) -> bool:
                         shift_paste = self.config_manager.get_setting('shift_paste', True)
                     if shift_paste:
                         result = subprocess.run(
-                            ['ydotool', 'key', '29:1', '42:1', '47:1', '47:0', '42:0', '29:0'],
+                            ['ydotool', 'key', '29:1', '42:1', paste_keycode_pressed, paste_keycode_released, '42:0', '29:0'],
                             capture_output=True, timeout=5
                         )
                     else:
                         result = subprocess.run(
-                            ['ydotool', 'key', '29:1', '47:1', '47:0', '29:0'],
+                            ['ydotool', 'key', '29:1', paste_keycode_pressed, paste_keycode_released, '29:0'],
                             capture_output=True, timeout=5
                         )