Terminal Error Audio Alerts

A VS Code extension that plays audio notifications when terminal commands fail. Helps developers quickly identify failed builds, compilation errors, and other terminal issues with customizable sound alerts.

Features

• 🔊 Automatically plays a sound when terminal errors are detected
• 🎲 Randomly selects from multiple sound files
• 🎚️ Configurable volume control
• ⚙️ Enable/disable the feature anytime
• 🖥️ Cross-platform support (Windows, Mac, Linux)
• ⚡ Activates automatically on VS Code startup

Installation

1. Clone or download this repository
2. Run npm install to install dependencies
3. Add your sound files (.wav, .mp3, or .ogg) to the sounds/ folder
4. Press F5 to open the extension in debug mode, or package it for release

Configuration

Open VS Code settings and search for "Ramesh Terminal Error Sounds":

• terminalErrorSound.enabled: Enable/disable error sound notifications (default: true)
• terminalErrorSound.volume: Volume level for error sounds, 0-1 (default: 0.5)

Commands

• Test Error Sound: Manually trigger the error sound to test it

Supported Error Patterns

The extension detects:

• command not found
• not recognized
• no such file or directory
• error: (case-insensitive)
• fatal:
• failed
• exception
• undefined is not
• cannot find
• permission denied
• syntax error
• invalid

Sound Files

Place your audio files in the sounds/ directory. Supported formats:

• .wav
• .mp3
• .ogg

The extension will randomly select one of the available sounds when an error is detected.

Development

npm install          # Install dependencies
npm run compile      # Compile TypeScript
npm run watch        # Watch for changes
npm run lint         # Run ESLint

Publishing

To package and publish to VS Code Marketplace:

npm install -g @vscode/vsce
vsce package
vsce publish

License

MIT