Support & Troubleshooting

Get help resolving issues and optimizing your VoiceVibe experience

Active Pro and Pro Max users can request priority support from the account dashboard.

Sign in to open dashboard support
Windows

Windows

Windows 10 or later

macOS

macOS

Apple Silicon Mac, macOS 14+

Linux

Linux

X11 Linux on x86-64; initial QA on Linux Mint

Windows

Windows Troubleshooting

Audio/Microphone Problems

No audio input detected: Go to Settings > Privacy > Microphone and ensure VoiceVibe is allowed to access your microphone
Poor recognition quality: Use a dedicated USB microphone, reduce background noise, and ensure your microphone is set as the default input device. Speak clearly at a normal pace, 6-12 inches from the microphone
Audio cutting out: Close other applications using the microphone, check sample rate settings in Sound Control Panel
VoiceVibe uses your system's default microphone. If it's picking up from the wrong device, change your system default input device:
Windows: Settings > System > Sound > Input
Restart VoiceVibe after changing the default device.

Keyboard Shortcut Not Working

Shortcut conflicts: Check for conflicts with other applications using the same key combinations. Some enterprise software or gaming overlays capture keys globally
VoiceVibe not running: Check the system tray to ensure VoiceVibe is running. Restart the application if needed
Try different keys: Go to VoiceVibe settings and configure a different keyboard shortcut
Run as administrator: Some applications require VoiceVibe to run with elevated privileges to receive keyboard input

Performance Problems

High RAM usage (Free tier): Voice Typing uses on-device AI and typically uses about 2.7 GB of RAM while the local model is loaded, or about 320 MB with the model unloaded. 8 GB total system RAM is recommended. Upgrade to Pro for cloud-based processing that uses significantly less memory
Slow processing: Close unnecessary applications, check your internet connection (for Pro modes), or restart VoiceVibe
High CPU usage: This is normal during transcription on Free tier. Pro uses cloud processing for lower CPU usage

Windows SmartScreen Warning

Windows SmartScreen can warn about new installers until enough people have downloaded and run them. This is common for newly released desktop apps, even when the installer is signed.
If you downloaded VoiceVibe from voicevibe.ai: click More info, then Run anyway.
If the file came from anywhere else: do not run it. Go back to the official download page and download a fresh copy.

Antivirus Blocking VoiceVibe

Some security software may flag VoiceVibe because of the system-level access it needs to work (keyboard shortcuts, audio recording, text insertion). This is normal for a voice productivity app.
Windows Defender: Settings > Windows Security > Virus & threat protection > Exclusions > Add the VoiceVibe installation folder
Other antivirus: Check your software's documentation for adding application exclusions

System Requirements

Supported: Windows 10 or later on modern x86/x64 processors (Intel, AMD from ~2013 onwards)
Not yet supported: Windows on ARM (Snapdragon, Qualcomm) is not currently supported
Coming soon: ARM support for Windows is on our roadmap for a future release
macOS

macOS Troubleshooting

Audio/Microphone Problems

No audio input detected: Grant microphone access in System Settings > Privacy & Security > Microphone
Poor recognition quality: Use a dedicated USB microphone, reduce background noise, check input levels in System Settings > Sound. Speak clearly at a normal pace, 6-12 inches from the microphone
Audio cutting out: Close other applications using the microphone, restart VoiceVibe
Permission denied after update: macOS may reset permissions after updates. Re-grant microphone access in System Settings > Privacy & Security
VoiceVibe uses your system's default microphone. If it's picking up from the wrong device, change your system default input device:
macOS: System Settings > Sound > Input
Restart VoiceVibe after changing the default device.

Keyboard Shortcut Not Working

Accessibility permissions required: Grant accessibility permissions in System Settings > Privacy & Security > Accessibility
Shortcut conflicts: Check System Settings > Keyboard > Keyboard Shortcuts for conflicts with system shortcuts
VoiceVibe not running: Check the menu bar to ensure VoiceVibe is running
After macOS update: You may need to re-grant accessibility permissions after system updates

Screenshots Not Working

If modes that use screenshots aren't capturing your screen, grant Screen Recording permission:
System Settings > Privacy & Security > Screen Recording > enable VoiceVibe
Restart VoiceVibe after granting this permission.

Performance Problems

High RAM usage (Free tier): Voice Typing uses on-device AI and typically uses about 2.7 GB of RAM while the local model is loaded, or about 320 MB with the model unloaded. 8 GB total system RAM is recommended. Upgrade to Pro for cloud-based processing that uses significantly less memory
Slow processing: Close unnecessary applications, check your internet connection (for Pro modes), or restart VoiceVibe
App Translocation: If downloaded from web, move VoiceVibe.app to Applications folder to avoid quarantine restrictions

System Requirements

Supported: Apple Silicon Macs (M1 or newer) running macOS 14 or later
Not currently supported: Intel-based Macs are not a supported build target
Older macOS versions: May work in some cases, but are not part of the supported release target
Linux

Linux Troubleshooting

Audio/Microphone Problems

No audio input detected: Ensure PulseAudio (or PipeWire with PulseAudio compatibility) is installed and running. Check that your microphone is recognized with arecord -l
Poor recognition quality: Use a dedicated USB microphone, adjust input levels with pavucontrol or alsamixer. Speak clearly at a normal pace, 6-12 inches from the microphone
Audio cutting out: Check for PulseAudio buffer issues, try adjusting fragment size in PulseAudio config
Permission issues: Ensure your user is in the audio group
VoiceVibe uses your system's default microphone. If it's picking up from the wrong device, change your system default input device:
Linux: Open your desktop's Sound Settings and change the input device
Restart VoiceVibe after changing the default device.

Keyboard Shortcut Not Working

Desktop environment conflicts: GNOME, KDE, and XFCE have different shortcut handling. Check your DE's keyboard shortcut settings for conflicts
X11 required: VoiceVibe supports X11 on x86-64 Linux. Linux Mint is the initial QA target; Wayland is not currently supported.
Try different keys: Some key combinations may be reserved by your desktop environment
VoiceVibe not running: Check the system tray to ensure VoiceVibe is running

Performance Problems

High RAM usage (Free tier): Voice Typing uses on-device AI and typically uses about 2.7 GB of RAM while the local model is loaded, or about 320 MB with the model unloaded. 8 GB total system RAM is recommended. Upgrade to Pro for cloud-based processing that uses significantly less memory
Slow processing: Close unnecessary applications, check your internet connection (for Pro modes), or restart VoiceVibe
AppImage issues: Make sure the AppImage is executable: chmod +x VoiceVibe*.AppImage

System Requirements

Supported Linux target: X11 on x86-64
Initial QA distro: Linux Mint
Not currently supported: Wayland and ARM Linux

Common Issues

When you first use offline Voice Typing, VoiceVibe downloads a speech recognition model for on-device voice processing. This is a one-time download; the app plus local model is about 2.9 GB on disk.
What to expect:
  • A progress indicator shows download status
  • Download time depends on your internet speed (typically 2-10 minutes)
  • The model is cached locally -- future launches load it from disk
If the download fails or stalls:
  • Check your internet connection
  • Ensure you have at least 5 GB of free disk space
  • Restart VoiceVibe to retry
Pro users: If you only plan to use cloud voice recognition, you can skip the local model. Go to Settings > General > Voice Recognition and set the provider to "Cloud."
Voice Typing on the Free tier loads an AI model. VoiceVibe typically uses about 2.7 GB of RAM while the local model is loaded, and about 320 MB when the model is unloaded. Before loading, VoiceVibe checks your available memory:
  • "Low memory" warning: You can proceed, but close other applications first for best results
  • "Insufficient memory" error: You don't have enough free RAM. Close other applications and try again
Tips to reduce memory usage:
  • Close browser tabs and other large applications before using VoiceVibe
  • Pro tier processes voice in the cloud and uses significantly less RAM
  • If Cloud with Local Fallback is selected, Voice Typing may use the local model while offline. Strict Cloud mode requires an internet connection.
Minimum recommended RAM: 8 GB total system RAM for comfortable free-tier use alongside other applications.
VoiceVibe uses your system's default microphone. If it's picking up from the wrong device, change your system default input device:
  • Windows: Settings > System > Sound > Input
  • macOS: System Settings > Sound > Input
  • Linux: Open your desktop's Sound Settings and change the input device
Restart VoiceVibe after changing the default device.
VoiceVibe works best with clear, steady microphone input:
  • Use a dedicated USB microphone or headset if possible.
  • Set your system input device to the microphone you actually want VoiceVibe to use.
  • Check the input meter in your OS sound settings. Your voice should register clearly without constantly hitting the maximum level.
  • If audio sounds distorted or clipped, lower the input volume.
  • If VoiceVibe misses words or hears very little, raise the input volume or move closer.
  • Keep the microphone about 6-12 inches from your mouth and speak at a normal pace.
  • Reduce background noise, keyboard noise, fans, music, and other people speaking nearby.
  • Close other apps that may be using the microphone.
  • After changing microphone or volume settings, restart VoiceVibe and try a short test recording.
All platforms:
  • Check if VoiceVibe is already running -- look in your system tray (Windows/Linux) or menu bar (macOS) for the VoiceVibe icon
  • If you can't find it but the app won't open, the previous instance may have crashed. Restart your computer, or force-quit:
    • Windows: Open Task Manager (Ctrl+Shift+Esc), find VoiceVibe, End Task
    • macOS: Open Activity Monitor, find VoiceVibe, Force Quit
    • Linux: Run pkill -f voicevibe in a terminal
Windows:
  • Check if antivirus software is blocking VoiceVibe -- add it to your exclusion list
  • Try running as administrator
macOS:
  • If you see "VoiceVibe is damaged and can't be opened," right-click the app and select Open, or go to System Settings > Privacy & Security and click "Open Anyway"
  • Make sure VoiceVibe.app is in the Applications folder -- macOS can cause issues if run from Downloads
  • After a macOS update, you may need to re-grant permissions
Linux:
  • For AppImage: ensure it's executable (chmod +x VoiceVibe*.AppImage)
  • Run from terminal to see error output: ./VoiceVibe*.AppImage
  • Check that PulseAudio (or PipeWire with PulseAudio compatibility) is running
If it keeps crashing: Check your log files and report a bug with the log attached. Logs are at: ~/.local/share/voicevibe/logs/ (Linux), ~/Library/Logs/VoiceVibe/ (macOS), or %LOCALAPPDATA%\VoiceVibe\Logs\ (Windows).
After VoiceVibe processes your voice, it types the result into whichever application was focused before you started recording. If text isn't appearing:
  1. Make sure the target app has focus -- click into the text field where you want text before pressing your keyboard shortcut
  2. Check the recording indicator -- make sure VoiceVibe actually recorded and processed your audio (you should see the overlay indicator)
  3. macOS: Check Accessibility permissions -- VoiceVibe needs Accessibility access to type into other apps. Go to System Settings > Privacy & Security > Accessibility and make sure VoiceVibe is enabled. Restart VoiceVibe after granting this
  4. Full-screen games or apps that capture keyboard input may block VoiceVibe's text insertion
  5. Security software may block simulated keyboard/clipboard input
Linux note: Some terminal emulators use Ctrl+Shift+V for paste instead of Ctrl+V. VoiceVibe handles this automatically for common terminals, but some may not be recognised.
Workaround: If a specific app doesn't receive text, try a simple text editor (Notepad, TextEdit, gedit) to confirm VoiceVibe is working, then copy-paste from there.
VoiceVibe uses keyboard shortcuts to activate voice modes. The default is Right Ctrl for Voice Typing.
Single keys: Right Ctrl, Right Alt, Left Ctrl, Left Alt, Right Shift, Left Shift, F6-F12
Key combinations: You can also use multi-key combinations (e.g., Ctrl+Shift+V). To set a custom combination, open Settings, go to the mode you want to configure, click the shortcut button, and press your desired key combination.
If a shortcut doesn't work:
  • Another application may be using the same key -- try a different one
  • macOS: Grant Accessibility permissions in System Settings > Privacy & Security > Accessibility
  • Linux: Your desktop environment may reserve certain keys -- check your DE's keyboard shortcut settings
  • Windows: Some enterprise software or gaming overlays capture keys globally

Subscription & Pro Features

Tier & Subscription Issues

Free tier: Voice Typing uses on-device AI. If not working, check RAM usage (about 2.7 GB while the local model is loaded, 8 GB total system RAM recommended) and verify microphone permissions
Pro tier: Requires internet connection for cloud AI. Check network connectivity and firewall settings
Pro modes locked? Verify your subscription is active in the dashboard, then open Settings > Status in VoiceVibe and click "Refresh Status."
Subscription not activating: Sign in to your dashboard at voicevibe.ai to verify subscription status. Active Pro and Pro Max users can request priority support from the account dashboard if issues persist
How to cancel: Visit your dashboard > Manage Subscription > Cancel. We offer a 7-day money-back guarantee; active Pro and Pro Max users can request help from the account dashboard.
Subscription cancelled? Upgrade to Pro ($14.99/mo) anytime to restore access to Pro voice modes

Subscription & Billing Issues

I subscribed but don't see Pro access: Open VoiceVibe and go to Settings > Status. Under Account Status, click "Refresh Status." If you see "Sign In" instead, sign in with the same email you used to subscribe.
How do I cancel my subscription? Sign in to your dashboard at voicevibe.ai > Manage Subscription > Cancel. You'll retain Pro access until the end of your billing period
Billing questions: View invoices and payment history in your dashboard. Manage payment methods through the Stripe customer portal (link in dashboard)
Refund requests: Active Pro and Pro Max users can request priority support from the account dashboard. Full refunds end paid access immediately. Beyond the 7-day guarantee, refunds for technical issues are considered case-by-case within 14 days of the charge
Pro modes stopped working: Check if subscription is active in your dashboard. Verify payment method is valid and up to date
After subscribing, sync your subscription status in the desktop app:
  1. Sign in with the same email you used to subscribe at voicevibe.ai
  2. Open Settings > Status and find Account Status
  3. Click "Refresh Status" (or "Check Status" if shown)
  4. Confirm your account status changes to Pro or Pro Max
  5. Restart VoiceVibe if the status hasn't updated after checking
Subscription activation is usually instant. If your Pro status still doesn't appear after 5 minutes, submit a priority support request from your account dashboard.
Pro features require an internet connection. If VoiceVibe shows "Offline" or isn't connecting:
  1. Check your internet connection -- try loading a website in your browser
  2. Corporate firewalls -- some corporate networks block persistent connections. Try a personal network
  3. VPN -- some VPNs interfere with persistent connections. Try disconnecting your VPN temporarily
  4. Wait for automatic reconnection -- VoiceVibe retries automatically. If it doesn't reconnect within 30 seconds, restart the app
While offline: Voice Typing can work when Local Model or Cloud with Local Fallback is selected. Strict Cloud mode and other Pro modes require an internet connection.
Paid usage allowances reset monthly on both monthly and annual subscriptions. If you've reached your limit:
  • Voice Typing can work offline when Local Model or Cloud with Local Fallback is selected
  • Other Pro modes are paused until your next monthly usage reset
  • Check your usage in Settings > Status tab
Need more capacity? Upgrade to Pro Max for 4x the usage limits. If you believe the limit was reached in error, active Pro and Pro Max users can submit a priority support request from the account dashboard.
  • "Registration failed": Ensure your audio sample is 5-10 seconds of clear speech with minimal background noise
  • "Too many attempts": Wait a few minutes before trying again. Voice clone registration is limited to 3 attempts per 5 minutes
  • "Maximum clones reached": You can have up to 3 custom voices. Delete an existing clone to create a new one
  • Clone sounds wrong: Record in a quiet environment, speak naturally, use a good microphone. Make sure your microphone input volume is set to an appropriate level -- too quiet or too loud both reduce clone quality
  • Clone disappeared: Voice clones are stored in the cloud. Check Settings > Voices for your clone list
  1. Ensure you have a Pro subscription -- TTS is Pro-only
  2. Check your internet connection -- TTS requires cloud processing
  3. Check your audio output -- make sure speakers/headphones are working and volume is up
  4. Try a preset voice -- if using a cloned voice, switch to a preset to rule out clone issues
  5. If the issue persists, the TTS service may be temporarily unavailable -- wait a few minutes and try again
VoiceVibe checks for updates automatically and notifies you when a new version is available. Click the notification to download and install. You can also download the latest version manually from voicevibe.ai/download.
Your current version is shown in Settings > Status tab.

Need More Help?

Bug reports and feedback are welcome here; Pro and Pro Max support requests are handled from the account dashboard.

When Reporting a Bug, Please Include:

  • Your platform (Windows, macOS, or Linux)
  • VoiceVibe version (shown in Settings > Status)
  • What you were doing when the issue occurred
  • What happened vs what you expected
  • Log files if possible: ~/.local/share/voicevibe/logs/ (Linux), ~/Library/Logs/VoiceVibe/ (macOS), %LOCALAPPDATA%\VoiceVibe\Logs\ (Windows)

Report a Bug

Found an issue? Help us fix it by reporting bugs with detailed information.

Report Bug

Request Feature

Have an idea for improving VoiceVibe? We'd love to hear your suggestions.

Request Feature
Send Feedback Check FAQ