vtmate
🇬🇧

Configuration

Background Shortcuts

Background mode listens for four global keyboard shortcuts, live in the [daemon] section of ~/.vtmate/settings (not the agents file - see Configure Agents), written as modifiers joined by +: ctrl, alt (or option), shift, cmd (or super), cmdorctrl, plus a key - letters, digits, f1..f12, escape, space, tab, arrows... e.g. ctrl+alt+a, shift+f5, cmd+alt+r.

SettingDefaultWhat it does
llm_background_ptt_comboctrl+alt+aTalk with an agent, with optional selected text as context.
tts_background_comboctrl+alt+rRead the selected text aloud.
stt_and_paste_background_ptt_comboctrl+alt+sTranscribe speech and paste it at the cursor.
llm_background_resetctrl+qStop the speech; twice resets the conversation.

On startup the daemon grabs all four shortcuts. If any is already taken by another application (some desktops bind ctrl+q or ctrl+alt combinations, for example) the daemon does not start, and vtmate --daemon lists the taken shortcuts so you can change them. On Windows, ctrl+alt is the same as AltGr on some keyboard layouts - rebind those if the daemon reports them as taken.