Skip to main content

A shortcut does nothing

1

Check Accessibility permission (macOS)

Global shortcuts need Accessibility permission. Open System Settings › Privacy & Security › Accessibility and make sure Vowen is on. If it is already listed, remove it and add it again rather than toggling it. See Permissions problems.
2

Check the row is switched on

In Settings › Shortcuts, each row has its own on/off switch. Start New Note and Paste Last Transcription are off by default.
3

Check Pause shortcuts in

If the shortcut only fails in one app, that app may be on the Pause shortcuts in list at the bottom of Settings › Shortcuts. Remove it from the list.
4

Check for conflicts

Quit other dictation apps that may use the same keys. On macOS, also check System Settings › Keyboard › Keyboard Shortcuts.
5

Record the shortcut again

Click the key box in Settings › Shortcuts and press the combination again.
6

Restart Vowen

Quit from the menu bar or tray icon and open Vowen again. A restart is needed after granting Accessibility permission.
If only the Command Mode Shortcut does nothing, Command Mode is probably switched off. Turn it on at the top of the Command Mode page in the sidebar. See Nothing happens when I press the Command Mode shortcut.

A quick tap discarded my recording

A press of the Transcription Shortcut shorter than 180 ms counts as a tap, not a dictation. In Hold mode Vowen keeps the recording open for 500 ms and waits for a second tap to lock it. If no second tap arrives, the recording is discarded silently. Hold the key a little longer while you speak, or tap twice to lock the recording. See Double-tap to lock.

Escape doesn’t reach my app while I dictate

This is deliberate. While a dictation or Command Mode recording is running and Cancel Recording is bound to bare Escape, Vowen takes the Escape press so it cancels the recording without closing a chat or dialog in the app behind it. If you need Escape in your app during a recording, for example in vim, rebind Cancel Recording to another key or switch it off. Vowen then leaves Escape alone.

Escape doesn’t cancel my recording

Check that Cancel Recording in Settings › Shortcuts is switched on and still bound to Escape. The Reset to default arrow next to a changed binding restores plain Escape.

Every shortcut stopped at once (macOS)

Under heavy load, macOS can cut Vowen off from the keyboard, and every shortcut stops at the same moment. Vowen recovers on its own:
  • It re-enables keyboard input as soon as macOS disables it.
  • A health check runs every 5 seconds and restarts the keyboard hook if it is not responding.
Expect a gap of a few seconds at most. If shortcuts are still dead after 10 seconds, work through A shortcut does nothing.

A recording won’t stop (macOS)

If keyboard input drops out during a Hold-mode dictation, the key release that ends the recording can be lost. Vowen watches for the release separately. If none arrives within 15 seconds, it stops the recording and transcribes what it captured, so you keep your text. The indicator may stay up for up to 15 seconds longer than expected.

Shortcuts are dead after sleep (Windows)

After the computer wakes or unlocks, Windows can stop delivering key events to Vowen without any error. Vowen clears stuck key state and reinstalls its keyboard hook after waking. If a recording is running, it waits for it to finish first. Wait a couple of seconds after waking. If shortcuts still don’t work, quit and open Vowen again. See also Windows: blank window or dead shortcuts after sleep.

Fn doesn’t register after install (macOS)

Quit and open Vowen again. If Fn still doesn’t work, restart your Mac.

Some keys can’t be recorded

  • Caps Lock can’t be recorded on its own. If you remap it to a Hyper key with Raycast or Karabiner, chords using the Hyper key work.
  • Escape can only be bound on Cancel Recording.
  • On macOS, keys that the system uses for brightness, such as F14 and F15 on some keyboards, may never reach the recorder.
  • F13 to F24 are supported and rarely clash with other apps.

Mouse button shortcuts

Left and right click can’t be bound. On Windows, extra mouse buttons are reported as M4 and M5 at most, whatever the mouse’s own software shows.
Vowen listens for mouse buttons but can’t block them, so the browser still sees Back and Forward. Bind Middle, or M6 to M8 on macOS, instead. You can also remap the button in your mouse software.
  • They follow the same Hold and Tap modes as keyboard shortcuts.
  • A press must last at least 300 ms, because some mice send duplicate presses for one click.
  • On Windows there is a short pause after release to ignore the extra middle-click that ending auto-scroll produces.

Keyboard layouts

Vowen stores shortcuts by physical key position, not by the character a key types. A shortcut recorded as Control + A on QWERTY fires on the same physical key on AZERTY, where it types Q. Key caps in Settings are drawn with your active layout and update when you switch layouts. Settings › Shortcuts scrolled to Start New Note, Paste Last Transcription, Cancel Recording and Pause shortcuts in
Punctuation keys are matched by physical position on both macOS and Windows, and the key cap shows the character your layout types. A shortcut recorded as Control + / on a US layout fires on the same physical key on a French layout.
The key next to Left Shift (PC) or left of 1 (Mac) on ISO keyboards can be bound. On macOS a bare binding on it is blocked from typing. On Windows Vowen can’t block it, so a bare binding still types its character. Add a modifier to avoid that.
If you used Vowen before layout support arrived and use a non-QWERTY layout, a one-time Some shortcuts may need to be updated dialog lists your shortcuts as Vowen now reads them. Looks good closes it. Something’s off opens Settings › Shortcuts. It never appears again.
On Spanish, French, Portuguese, German or Czech layouts, older versions could make dead keys fail every other time. Update to the current version. Changing your shortcuts won’t help.

Other cases

Some apps take certain keys before Vowen sees them: F7 in browsers turns on caret browsing, terminals often bind Ctrl + Shift, and remote-desktop apps capture shortcuts wholesale. Pick another combination, or add the app to Pause shortcuts in if you want Vowen to step aside there.
  • Check the microphone is connected and selected in Settings › Audio. See Microphones.
  • Make sure no other app holds the microphone exclusively.
  • On Windows, check Windows Settings › Privacy & security › Microphone. Vowen can’t detect a Windows-level block.
Recording starts as soon as the shorter shortcut is pressed. If you complete a longer shortcut of the same kind within 500 ms, the running recording switches to the longer shortcut’s AI setting without restarting. Switching from push-to-talk to Hands-Free Mode has no time limit. If this isn’t what you want, make the two shortcuts more distinct.
Add an alternative under Transcription Shortcut or Hands-Free Mode and set its AI chip to Enhance with AI or Off. New alternatives start at Off. The primary shortcut has no chip and follows the global AI enhancement setting. Alternatives need Pro.
Accessibility keyboards, Sticky Keys or automation tools can report modifiers you are not holding. Vowen ignores key presses that carry modifiers it never saw pressed. If it still happens, update Vowen and check for latched modifiers on the accessibility keyboard.