Faah — Terminal Error Sound

An audible alert for VS Code — get notified the moment a terminal command fails, without having to watch the screen.

How it works

Faah monitors your integrated terminals in the background. When a command fails, it plays a sound. It triggers on two conditions:

Exit code — the command exits with a non-zero status
Error output — the output contains words like error, failed, fatal, exception, traceback, or panic

A short cooldown prevents repeated playback for the same failure.

Requirements

Linux only. One of the following audio players must be installed:

Player	Install
mpg123	`sudo apt install mpg123`
ffplay	`sudo apt install ffmpeg`
cvlc	`sudo apt install vlc`

The extension tries them in order and uses the first one found. If none are available, a notification will guide you.

Troubleshooting

No sound plays

Ensure at least one audio player from the list above is installed
Check that your system volume is not muted

Errors not detected Faah uses VS Code's built-in shell integration, which is active by default for bash, zsh, fish, and PowerShell. It does not work with cmd.exe. If the circle indicator is missing from the terminal toolbar, shell integration is not active in that session.

Contributing

Issues and pull requests are welcome at github.com/saidurpulok/faah-for-error.

License

MIT