Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vowen.ai/llms.txt

Use this file to discover all available pages before exploring further.

Text Not Pasting

Symptoms: Transcription appears in the Voice Log but isn’t pasted into your app. Solutions:
  1. Check that Settings > General > Auto-paste transcription is enabled
  2. Verify the target app has an active text field with focus
  3. Try completely quitting Vowen (right-click tray > Quit) and relaunching
  4. On macOS, ensure Accessibility permission is granted
  5. Try switching text insertion method: Settings > General > Text Insertion Method → “Direct typing”
If only a “v” appears when pasting, the app may not support standard paste. Switch to “Direct typing” method in Settings > General.

”Local Whisper Server Is Not Running”

Symptoms: A banner appears saying the server isn’t running, clicking restart doesn’t help. Solutions:
  1. Delete the current model and re-download it (Settings > Models)
  2. Check that your antivirus hasn’t quarantined model files
  3. Try a different model (e.g., switch from Base to Tiny to test)
  4. On Windows, ensure Visual C++ Redistributable is installed
  5. Enable Resource Efficient Mode in Settings > General as a workaround

”Thank You” Appears in Output

Symptoms: The transcription outputs “Thank you.” even though you didn’t say it. Cause: This is a known Whisper hallucination that occurs when the model processes silence. Solutions:
  • Start speaking immediately when you press the shortcut (don’t wait)
  • Enable cloud silence detection in Settings > Recording
  • Vowen’s junk detection catches most of these automatically — if you’re seeing it, update to the latest version

First or Last Word Cut Off

Symptoms: The beginning or end of your speech is missing from the transcription. Solutions:
  • Pause for half a second after pressing the shortcut before speaking
  • Continue speaking for a brief moment before releasing the shortcut
  • This is being continuously improved — make sure you’re on the latest version

Shortcut Not Working

Symptoms: Pressing the shortcut does nothing. Solutions:
  1. macOS: Ensure Accessibility permission is granted (System Settings > Privacy & Security > Accessibility)
  2. After granting permission, fully quit and relaunch Vowen
  3. Check for conflicts with other apps that use the same shortcut (close WisprFlow, Superwhisper, etc.)
  4. Try recording a new shortcut in Settings > Shortcuts
  5. On macOS, the Fn key may not register right after installation — restart the app
See Shortcut Issues for more detailed troubleshooting.

Recording Indicator Not Showing

Symptoms: You hear the recording sound but don’t see the indicator pill. Solutions:
  • The indicator may be on a different monitor — check all screens
  • Try restarting Vowen
  • Check Settings > General > Recording Indicator Position (top/bottom)

App Running Slow / High Memory

Symptoms: Vowen using excessive CPU or RAM. Solutions:
  • Enable Resource Efficient Mode (Settings > General, at the bottom)
  • Switch to a smaller model (Tiny/Base instead of Large)
  • The Large v3 model uses 3-4 GB RAM — this is normal
  • Models are only loaded when transcribing; they should idle between uses
See Performance for more details.

Cloud Model Not Working

Symptoms: Selected a cloud model but getting no transcription output. Solutions:
  1. Check your internet connection
  2. Verify your API key is correct (Settings > Models or AI Setup)
  3. Check the provider’s status page for outages
  4. Try completely quitting and relaunching Vowen
  5. Check your API usage — you may have hit rate limits on the free tier

Still Stuck?

If none of the above solves your issue:
  • Join our Discord community for help from the team and other users
  • Check the specific troubleshooting pages in the sidebar for more detailed guides