ErrorTone
Play an audio alert when your terminal commands produce errors. No configuration required — just install and start hearing alerts.
Features
- Automatic error detection: Monitors all integrated terminals for error patterns
- 10 built-in patterns:
error, Error, ERROR, Exception, Traceback, Failed, Segmentation fault, panic:, npm ERR!, ModuleNotFoundError
- Custom audio file: Use your own
.mp3, .wav, or .ogg alert sound
- Custom patterns: Add your own error detection patterns (plain text or regex)
- Smart debouncing: Prevents audio spam when errors repeat rapidly
- Volume control: Adjust alert volume from 0.0 (muted) to 1.0 (full)
- Cross-platform: Works on macOS, Linux, and Windows
Requirements
- VS Code 1.93.0 or later
- Shell integration enabled (default for bash, zsh, PowerShell, fish)
Commands
| Command |
Description |
ErrorTone: Enable |
Enable terminal monitoring and audio alerts |
ErrorTone: Disable |
Disable terminal monitoring and audio alerts |
ErrorTone: Test Sound |
Play the currently configured alert sound |
ErrorTone: Set Audio File |
Pick a custom audio file for alerts |
ErrorTone: Reload Patterns |
Re-read error detection patterns from settings |
Settings
| Setting |
Type |
Default |
Description |
errorTone.enable |
boolean |
true |
Enable or disable the extension |
errorTone.audioFilePath |
string |
"" |
Path to custom audio file (empty = bundled default) |
errorTone.volume |
number |
0.8 |
Playback volume (0.0–1.0) |
errorTone.useRegex |
boolean |
true |
Treat custom patterns as regular expressions |
errorTone.customPatterns |
string[] |
[] |
Additional error patterns to detect |
errorTone.debounceCooldown |
number |
3 |
Minimum seconds between alerts (0 = no debounce) |
Examples
Add a custom error pattern
{
"errorTone.customPatterns": ["\\[FATAL\\]", "CRITICAL"],
"errorTone.useRegex": true
}
Use a custom sound at lower volume
{
"errorTone.audioFilePath": "/path/to/my-alert.mp3",
"errorTone.volume": 0.5
}
- macOS: Uses
afplay for audio playback with native volume control
- Linux: Uses
paplay (PulseAudio) or aplay (ALSA) — install PulseAudio for volume support
- Windows: Uses PowerShell
System.Media.SoundPlayer
- Remote/SSH: Shell integration may be limited — extension degrades silently
- WSL: Works with PulseAudio audio backend configured
License
MIT
| |