Bug Beep
A VS Code extension that plays a sound on save when it detects problems in your file — so you get an audible cue without watching the Problems panel.
Features
- Plays a sound when you save a file that contains:
- Errors — compilation errors, type errors, syntax errors, etc.
- Unused variables — declared but never used
- Unused imports — imported but not referenced
- Works with diagnostics from your language extensions (ESLint, TypeScript, etc.)
- Automatically adjusts playback volume based on your system volume to keep it non-intrusive
Requirements
- macOS (uses
afplay for audio playback)
- VS Code
^1.105.0 or later
Extension Settings
| Setting |
Type |
Default |
Description |
bugBeep.soundFilePath |
string |
"" |
Absolute path to a custom sound file (.wav, .mp3, .aiff, etc.). Leave empty to use the default built-in sound. |
Using a Custom Sound
You can replace the default beep with any sound file on your machine:
- Open VS Code Settings (
Cmd + ,)
- Search for
bugBeep.soundFilePath
- Set it to the absolute path of your sound file
Or add it directly to your settings.json:
{
"bugBeep.soundFilePath": "/Users/you/Downloads/my-sound.mp3"
}
Leave the value empty ("") or remove the setting to use the default built-in sound.
Volume Behavior
Bug Beep automatically scales playback volume based on your current system volume to keep the alert subtle:
| System Volume |
Playback Ratio |
| 90–100% |
0.03 |
| 80–89% |
0.05 |
| 70–79% |
0.1 |
| 50–69% |
0.15 |
| 30–49% |
0.3 |
| Below 30% |
1.0 (no reduction) |
Your system volume is never changed.
Commands
| Command |
Description |
Bug Beep: Check and Play |
Manually check the active file and play the sound if issues are found |
Known Issues
None at this time. If you run into problems, please open an issue in the repository.
Release Notes
0.0.1
Initial release.
Enjoy coding with Bug Beep!
| |
