Fix dictation text insertion on Wayland
If transcription works but text does not appear on Wayland, check the insertion helper and compositor support. If recording never starts, diagnose the hotkey separately. A working microphone and transcript do not establish that the desktop permits simulated input.
By WhisperJot · Documentation reviewed
Locate the failing stage
Use the app's on-screen recording control for a short capture to separate the global hotkey from the rest of the pipeline. Recover a saved transcript from History before changing configuration.
| Symptom | Investigate |
|---|---|
| Hotkey does nothing | Global shortcut portal or configured trigger |
| Recording starts, no speech captured | Audio input and recording access |
| Transcript exists, editor stays empty | Insertion helper, session type, and focus |
| Manual paste works | Simulated input rather than transcription |
Check the session and installed helpers
The first command reports the advertised session type. The second lists helpers available on your command path. A missing path is useful evidence, but an installed executable alone does not prove that the compositor or its service permits it to type.
wtype requires the compositor's virtual-keyboard protocol. xdotool is an X11 tool and is not a general solution for native Wayland windows. ydotool uses uinput and a daemon; consult your distribution's package and service instructions. Avoid broad device-permission changes as a first troubleshooting step.
printenv XDG_SESSION_TYPE command -v wtype dotool ydotool xdotool wl-copy xclip
Retest one input path
Global shortcut portals and text insertion are separate capabilities. A successful portal shortcut does not imply that wtype is supported. Old distribution packages may also use different helper command syntax.
- Choose the helper appropriate to your session and follow its package documentation for setup.
- Open a scratch editor and verify that ordinary typing and manual paste work.
- Keep the editor focused and dictate one short sentence.
- If it fails, record the compositor, session type, helper version, and whether manual paste worked. Include those observations with a support report.
Questions
Why does the hotkey work but text never appears?
The shortcut starts recording through one desktop mechanism, while insertion uses another. Check the transcript, then investigate the helper and target field rather than reinstalling the speech model.
Will installing xdotool fix native Wayland apps?
Not generally. xdotool targets X11. Identify your session and compositor and choose an input path it supports; XWayland and native Wayland windows can behave differently.
Sources and related guides
Product behavior is based on the documentation below, reviewed 2026-09-09. Examples are authored illustrations; measurement worksheets are for your own observations.