Getting started
2026-03-18 ยท 5 min
Onboarding
On first launch, an 8-step wizard guides you through: language selection, shortcut setup, microphone test and interactive demo.
- 1Choose your interface language (15 languages available)
- 2Set up your keyboard shortcut (F8 by default)
- 3Test your microphone with the volume indicator
- 4Try live dictation with the interactive demo
- 5Select your preferred writing tone
Keyboard shortcut
By default, press F8 to start dictation, and release to stop. The shortcut is fully customizable.
- Supported combos: Ctrl+Shift+V, Alt+R, F1-F12, etc.
- Configurable in Settings > General
- Hot-reload: the new shortcut takes effect immediately
F8 is a great default choice: it doesn't conflict with any common shortcut in IDEs or browsers.
Activation method
3 options in settings: keyboard shortcut only, VoxWave icon only (click the widget or the tray), or both combined.
Floating widget
The orb widget appears during dictation with an animation that reacts to your voice. It displays 4 distinct visual states:
- Idle: subtle breathing animation (white glow)
- Recording: reactive ring matching amplitude + timer
- Processing: animated dots during processing
- Error: red glow with error message
Hover over the widget in idle mode to quickly access settings or quit the application.
Auto-stop
When enabled, VoxWave automatically stops recording after a period of silence โ no need to press the shortcut again. Powered by Silero VAD, a neural network that accurately distinguishes speech from background noise.
- 1Open Settings (tray click or hover widget > gear icon)
- 2Go to the Audio tab
- 3Enable 'Auto-stop after silence'
- 4Choose the silence duration (2s, 3s or 5s โ default is 2s)
Auto-stop is great for hands-free dictation: just speak and VoxWave handles the rest. Increase the duration to 3-5s if you tend to pause between sentences.
Audio feedback
Short beeps confirm the start, end, success or error of a dictation. Volume is configurable and can be disabled in audio settings.
How to quit VoxWave
VoxWave runs in the background โ closing a settings window or dialog does not quit the application. Here are the three ways to fully exit:
- Right-click the tray icon and select 'Quit'
- Open Settings > Help and click the 'Quit' button at the bottom
VoxWave stays in the system tray so it is always ready for dictation. Closing a dialog just hides it โ the app keeps running.