Sound on Error
A VS Code extension that plays an audible alert whenever errors appear in your editor, terminal, or debug console. Never miss an error again.
Features
- Editor Diagnostics -- plays a sound when new linter or compiler errors appear (red squiggles)
- Terminal Errors -- plays a sound when a terminal command exits with a non-zero code
- Debug Console -- plays a sound on stderr output or unhandled exceptions during debugging
- Custom Sound -- use any audio file (WAV, MP3, OGG, etc.) as your error alert
- Debouncing -- configurable cooldown so rapid errors don't spam you
- Severity Filter -- choose whether warnings also trigger the sound, or only errors
Commands
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and search for:
| Command |
Description |
Sound on Error: Test Sound |
Play the current sound to verify it works |
Sound on Error: Toggle Enable/Disable |
Quickly enable or disable the extension |
Sound on Error: Select Custom Sound File |
Open a file picker to choose your own sound |
Settings
Configure in Settings (Ctrl+,) under "Sound on Error":
| Setting |
Type |
Default |
Description |
soundOnError.enabled |
boolean |
true |
Master toggle |
soundOnError.soundFilePath |
string |
"" |
Path to a custom sound file (empty = bundled default) |
soundOnError.triggerOn |
array |
["diagnostics", "terminal", "debug"] |
Which error sources trigger the sound |
soundOnError.severityLevel |
array |
["error"] |
Diagnostic severities to alert on (error, warning) |
soundOnError.debounceMs |
number |
1000 |
Minimum ms between consecutive sounds |
Requirements
This extension uses your system's audio player to play sounds:
- Linux:
aplay, mpv, mplayer, or play (SoX)
- macOS:
afplay (built-in)
- Windows: PowerShell
Media.SoundPlayer (built-in)
Most systems have at least one of these available by default.
Installation
From Marketplace
Search for "Sound on Error" in the VS Code Extensions view (Ctrl+Shift+X).
From VSIX
- Download the
.vsix file from the Releases page
- Run:
code --install-extension sound-on-error-1.0.0.vsix
License
MIT
| |