Faahhh Terminal Sound

Plays a custom sound whenever your terminal outputs an error, warning, crash, or any keyword you define.

Never miss a silent terminal failure again — get an instant audio alert!

Features

Bring your own sound — point to any .wav or .mp3 file on your machine
Adjustable volume (0–100)
Configurable delay before the sound plays
Fully customizable keywords — error, warning, crash, exception, failed, panic — you choose!
Instant playback — debounced so a wall of errors only plays once
Cross-platform — works on Windows, macOS, and Linux
Zero npm dependencies — lightweight and doesn't slow down your editor

State-Based Audio Feedback: Monitors terminal processes, Notebook executions, tasks, and debug sessions. It triggers distinct audio cues automatically when commands succeed or fail based on their process exit code (no shell integration required).
Multiple Audio Tracks: Provide an array of custom .wav or .mp3 files for both success and failure events.
Dynamic Track Selection: Configure the extension to play a specific track index or randomize playback from your array to keep audio feedback fresh.
Configurable Playback Modes: Tailor the extension to your workflow. Set it to trigger on Failures Only (default), Successes Only, Always, or Never when focus is required.
Zero-Latency Engine: Engineered without external NPM dependencies. Utilizes native OS capabilities to guarantee instantaneous playback with zero performance overhead.
Bundled Defaults: Ships natively with a distinct error sound and a crisp success chime (no initial configuration required).

Access settings via Preferences: Open Settings (UI) (Ctrl+,) and search for Faahhh.

Setting	Default	Description
`faahhh.playMode`	`Only Failures`	Determines when audio plays: `Always`, `Only Failures`, `Only Successes`, or `Never`.
`faahhh.volume`	`100`	Playback volume scaling (0–100).
`faahhh.delay`	`0`	Debounce threshold and playback delay in milliseconds.
`faahhh.failSounds`	`[]`	Array of absolute paths to custom failure audio files. Defaults to the bundled "Faahhh" sound.
`faahhh.failTrackMode`	`Specific Track`	`Specific Track` or `Random` selection from your failure sounds array.
`faahhh.failTrackNumber`	`1`	The 1-based index of the track to play if `Specific Track` is selected.
`faahhh.successSounds`	`[]`	Array of absolute paths to custom success audio files. Defaults to the bundled success chime.
`faahhh.successTrackMode`	`Specific Track`	`Specific Track` or `Random` selection from your success sounds array.
`faahhh.successTrackNumber`	`1`	The 1-based index of the track to play if `Specific Track` is selected.

Fully compatible with any development environment utilizing the VS Code Extension API ecosystem, including:

Faahhh: Toggle Error Sound: Use the Command Palette or click the status bar item to instantly mute/unmute the extension globally.
Faahhh: Test Sound Output: Manually trigger audio playback to verify your configuration and volume levels.

Sumit

This extension is licensed under the MIT License.