Faaaaaahhhh Sound

Play a fail sound when a terminal command exits with a non-zero code.

Features

• Plays media/fahhhhh.mp3 when a command fails in an integrated terminal.
• Provides a manual test command: Play Fail Sound (Test).
• Can be enabled or disabled through settings.

Requirements

This extension needs an MP3-capable CLI player installed on your machine.

Linux examples:

• sudo apt install mpg123
• sudo apt install ffmpeg (for ffplay)

Notes:

• aplay is intentionally not used because it does not decode MP3 reliably.
• Terminal fail detection depends on VS Code shell integration events.

Extension Settings

This extension contributes:

• failSound.enabled (boolean, default: true)

Commands

• Play Fail Sound (Test) (faaaaaahhhh-sound.playTestSound)

Usage

1. Install and enable the extension.
2. Open an integrated terminal.
3. Run a failing command such as false or ls /does-not-exist.
4. The fail sound plays when exit code is non-zero.

Known Issues

• If no MP3-capable player is installed, the extension shows a warning and no sound is played.
• If shell integration is unavailable for a terminal session, fail events may not be emitted.

Release Notes

0.0.1

• Initial public release.
• Added terminal command failure detection.
• Added manual test command.
• Added fail-sound enable/disable setting.