Skip to main content
On macOS, Vowen needs your permission to record, to listen for shortcuts and to type into other apps. On Windows there is nothing to grant except the microphone switch in Windows’ own privacy settings.

Check what Vowen has

Open Settings › Permissions. Each row shows Granted, or an Open Settings button that opens the matching System Settings pane. The list refreshes when you switch back to Vowen, so you can grant a permission and watch the row change. Settings › Permissions with Microphone Access, Accessibility and Screen Recording all Granted
Settings search skips the Permissions section. Open it from the Settings sidebar.
If Microphone or Accessibility is missing, a banner titled System permissions required appears in the main window. Click Configure to open Settings › Permissions.

Accessibility (macOS)

Symptoms
  • Shortcuts do nothing
  • Text is not pasted into your app
  • A Drag to insert card appears after every dictation, with the line “Grant Accessibility permission so Vowen can insert text for you.”
Fix
1

Open the permission

In Settings › Permissions, click Open Settings next to Accessibility.
2

Drag Vowen into the list

System Settings opens next to a small card that reads Drag Vowen into the Accessibility list. Drag the card into the list. The card closes once the permission is granted.
3

Restart Vowen if shortcuts stay dead

Fully quit Vowen from the menu bar icon (Quit Vowen) and open it again.
If Vowen is already in the list but switched on, toggling it rarely helps. Remove it with the minus button, then add it again.

Microphone

Symptoms
  • The indicator shows recording, but nothing is transcribed
  • The transcript comes back empty, or as “Thank you” on a local model
Fix
  1. On macOS, open System Settings › Privacy & Security › Microphone and turn on Vowen.
  2. Check the device in Settings › Audio › Microphone.
  3. Test the microphone in another app.

Screen Recording (macOS)

Symptoms
  • Meeting notes capture only your voice, not the other side of the call
  • Command Mode cannot see your screen with Context-awareness on
  • Drag to capture region or click screenshots come back blank
  • Capture screenshots while dictating stays greyed out
Fix
  1. In Settings › Permissions, click Open Settings next to Screen Recording.
  2. Drag the card into the list, or turn Vowen on in Privacy & Security › Screen & System Audio Recording.
  3. Quit and reopen Vowen.
Dictation never needs Screen Recording. Context-awareness lives on the Command Mode page and is off by default.

Automation (macOS)

Vowen uses System Events to read which app is in front. That is what makes per-app tones match. The first time this runs, macOS asks whether Vowen may control System Events. If you deny it, dictation still works but app-specific tones never activate. To fix it, open System Settings › Privacy & Security › Automation, find Vowen and turn on System Events.

Granted, but still not working

Work through these in order.
1

Fully quit Vowen

Closing the window is not enough. Click the menu bar icon and choose Quit Vowen.
2

Wait a few seconds, then reopen it

Reopening too quickly can leave the old process running.
3

Remove and re-add the permission

Remove Vowen from the list with the minus button, then add it back.
4

Restart your Mac

Some permission changes only apply after a restart.
5

Reset the permission

Open Terminal and run the line for the permission you are fixing. Then grant it again.
Always include com.vowen.app. Without it, tccutil reset clears that permission for every app on your Mac.

Vowen is missing from the list

  • Open Vowen at least once. macOS only lists apps that have asked.
  • Drag Vowen from /Applications into the list.
  • If you moved the app after granting a permission, macOS may still track the old copy. Move Vowen back to /Applications, reset with tccutil, and grant it again.

Windows

Windows does not ask for Accessibility or Screen Recording. Shortcuts, pasting, screenshots and system audio work without a grant.
On Windows, Settings › Permissions always shows Microphone Access as Granted, because Vowen cannot read Windows’ privacy switch. If microphone access is blocked in Windows, Vowen records silence.
If recordings come back empty:
  1. Open Windows Settings › Privacy & security › Microphone.
  2. Turn on Microphone access and Let desktop apps access your microphone.
  3. Check the device in Settings › Audio › Microphone.
  4. Make sure no other app has taken exclusive control of the device.