Troubleshooting
Common issues and their solutions.
Sounds don't play when the app is minimized
Make sure Hotkey Mode is enabled in Global Settings. Without it, keys only work when the app window has focus.
A hotkey doesn't register
The key combination may be in use by another application. Try a different combo. If developer tools are enabled (F12), check the console for registration warnings.
No sound from a specific key
- Check that the key has a sound bound (click it to see Key Settings)
- Check the per-sound volume slider isn't at zero
- Check the master volume isn't at zero
- Make sure the soundboard is turned On (power button in header)
- Verify the correct output device is selected
Audio device names show as empty
Click the output device dropdown — the app will request microphone permission to unlock device labels. The microphone is never used or recorded.
AI Sound Generation fails
- Verify your ElevenLabs API key is correct
- Ensure the key has "Sound Effects" and "User read" permissions enabled
- Check your ElevenLabs account has remaining credits
- Try a simpler prompt if complex descriptions fail
App doesn't start with Windows
- Enable "Auto-Run at Startup" in Global Settings
- Some antivirus software may block auto-start registry entries — add an exception for ezAudioDeck
Sounds have a delay
- Built-in synth sounds are instant
- Custom audio files are cached in memory on load for near-zero latency
- Very large audio files (over 50MB) may take longer to cache initially
- For best results, use short clips under 30 seconds
Window doesn't come to front when restoring
If the window restores but stays behind other windows, try pressing the Minimize Hotkey twice. This can happen when another application is holding foreground focus.
Settings or bindings lost
Settings and bindings are stored in the browser's local storage and IndexedDB. Clearing browser data or the WebView2 cache will reset everything. Use Export Profile regularly to back up your configurations.