All writingEnglish

Dictating into tmux with Handy on KDE

When I type a prompt, I tend to make it too rigid. If I talk it through, I can ramble about what I want to do and include details I’d otherwise leave out. I get better results from LLMs that way.

I run tmux inside kitty on Void Linux. When I first tried dictating into a prompt with Handy, some characters went missing as it typed out the transcript. Pasting the whole sentence worked. KDE handles the shortcut that starts and stops Handy, and Handy just pastes in the result into whatever the active window is.

Trigger Handy from KDE

I installed the Handy AppImage as /usr/local/bin/handy and downloaded Cohere Transcribe from Handy’s model picker. Handy runs the model locally.

I originally kept the executable in my user-local bin directory, where KDE couldn’t find it by name. Using the full path in the shortcut fixed that lookup.

In KDE System Settings → Keyboard → Shortcuts, I added a Command or Script shortcut and bound Super+Ctrl+Shift+D to this command.

/usr/local/bin/handy --toggle-transcription

The command talks to the running Handy instance. One press starts recording and a second stops it. If Handy already has the same global shortcut, clear that binding so KDE handles it once.

Obviously no human ever would press a shortcut combination like Super+Ctrl+Shift+D. I intentionally picked such obscure combination and assigned it to a macro key.

Paste into the active tmux pane

In Handy’s paste settings I selected Ctrl+Shift+V. Now I leave the pane focused, press the KDE shortcut, speak and press it again. Handy transcribes locally and triggers the paste. The sentence sits at the prompt until I’ve read it and pressed Enter.

References