Skip to content

armgit / Handy

Public Imported from GitHub
0

A free, open source, and extensible speech-to-text application that works completely offline.

docs: add overlay, wl-clipboard and non-QWERTY paste notes to the Ubuntu notes (#2212)

Benoit GALATI586a838cec1b
diff --git a/docs/troubleshooting/ubuntu-26-04-gnome-wayland/README.md b/docs/troubleshooting/ubuntu-26-04-gnome-wayland/README.md
index 724812ea..88000519 100644
--- a/docs/troubleshooting/ubuntu-26-04-gnome-wayland/README.md
+++ b/docs/troubleshooting/ubuntu-26-04-gnome-wayland/README.md
@@ -60,3 +60,36 @@ handy-keys shortcuts initialized
```
Then use your existing Handy shortcut and test dictation.
+
+## 4. Hide the overlay
+
+On GNOME, the overlay is a regular window that can take the focus, so nothing is pasted. Set **Overlay** to **None**.
+
+## 5. Install wl-clipboard
+
+Handy uses `wl-copy` on Wayland when it is installed:
+
+```bash
+sudo apt install wl-clipboard
+```
+
+## 6. Non-QWERTY keyboard layouts
+
+`ydotool` sends physical keys, so the built-in paste methods fail on layouts such as bépo or Dvorak: Ctrl+V presses the QWERTY `V` key, and Shift+Insert breaks while a modifier of your shortcut is still held.
+
+Use an external script instead: it presses Ctrl and the key that types `v` on your layout, `KEY_U` (22) on bépo or `KEY_DOT` (52) on Dvorak (codes in `/usr/include/linux/input-event-codes.h`).
+
+Create `~/.local/bin/handy-paste`, here for bépo:
+
+```sh
+#!/bin/sh
+printf '%s' "$1" | wl-copy
+sleep 0.1
+ydotool key 29:1 22:1 22:0 29:0
+```
+
+```bash
+chmod +x ~/.local/bin/handy-paste
+```
+
+Set **Paste Method** to **External Script** with this path.