AT-SPI2 integration

Optional accessibility integration that gives you direct text insertion, context-aware transcription, and automatic code mode for terminals and IDEs.

What it does

Direct text insertion

When atspi.injection is enabled, voxctrl uses AT-SPI2 as the primary text-insertion method, inserting text directly into the focused widget instead of simulating keystrokes. If a widget doesn't expose a usable text interface, the app falls back to wtype/xdotool.

Context-aware transcription

When atspi.context_prompt is enabled, voxctrl reads the surrounding text from the focused text field via AT-SPI2 and includes it in the Whisper initial_prompt. This primes the model with your document's vocabulary, spelling, and style — improving transcription continuity and consistency on specialised terminology and proper nouns without manual prompt config.

Auto code mode

When atspi.auto_code_mode is enabled, voxctrl detects when the focused application is a code editor or terminal and automatically enables code-mode post-processing for that dictation — without changing your global Settings.

Configuration