Terminal Error Sound Alert (VS Code Extension)

Plays a random custom sound when a terminal command fails (non-zero exit code).

Setup

1. Put any number of audio files in this extension folder:
   • audio/
2. Supported extensions: .wav, .mp3, .ogg, .m4a, .flac, .aac
3. (Optional) Add extra absolute paths in setting terminalErrorSoundAlert.audioFilePaths.
4. (Optional) Run command: Terminal Error Sound Alert: Test Sound.

How detection works

The extension can trigger on:

• Non-zero terminal shell exit code when terminalErrorSoundAlert.useShellExitCode is enabled.
• Sound is picked randomly from all available audio files.

Settings

• terminalErrorSoundAlert.audioFilePaths: optional list of extra absolute audio file paths.
• terminalErrorSoundAlert.audioFilePath: deprecated single-file fallback.
• terminalErrorSoundAlert.debounceMs: cooldown between sounds.
• terminalErrorSoundAlert.useShellExitCode: trigger on non-zero command exit.

Local test

1. Open this folder in VS Code.
2. Press F5 to launch an Extension Development Host.
3. Make sure audio files exist under audio/.
4. Open terminal in that window and run a failing command like ls /path/that/does/not/exist.
5. You can also run command: Terminal Error Sound Alert: Test Sound.
6. Optional packaged test:
   • npm run package
   • VS Code -> Extensions view -> ... menu -> Install from VSIX...
   • Select terminal-error-sound-alert-0.0.2.vsix

Publish to VS Code Marketplace

1. Create a publisher in Visual Studio Marketplace.
2. Replace "publisher": "local" in package.json with your publisher ID.
3. Create a Personal Access Token (PAT) for Marketplace publishing.
4. In this project:
   • npm install
   • npx @vscode/vsce login <your-publisher-id>
   • npm run package (creates a .vsix for local install/share)
   • npm run publish

Notes

• Linux playback tries paplay, then aplay, then ffplay.
• macOS playback uses afplay.
• Windows playback uses PowerShell SoundPlayer.