Faa-Sound is a lightweight VS Code extension that plays an audible error sound whenever a command in your integrated terminal exits with a non-zero exit code.
✨ Features
🎵 Instant audio feedback — hear a sound the moment a terminal command fails
🔍 Real-time error detection — scans terminal output for error patterns as they appear (e.g., Error:, TypeError, FATAL)
⚙️ Custom sound — use your own .wav or .mp3 file
🎯 Customizable patterns — configure which text patterns trigger the error sound
🔇 Toggle on/off — quickly enable or disable from the Command Palette
🛡️ Ignore specific exit codes — skip sounds for Ctrl+C (exit 130) by default
⏱️ Smart debouncing — prevents sound spam when multiple errors fire rapidly
🖥️ Cross-platform — works on Windows, macOS, and Linux
🚀 Getting Started
Install the extension from the VS Code Marketplace
Open any terminal in VS Code
Run a command that fails (e.g., exit 1) — you'll hear the error sound!
⚙️ Settings
Setting
Type
Default
Description
terminalErrorSound.enabled
boolean
true
Enable/disable the extension
terminalErrorSound.customSoundPath
string
""
Absolute path to your own .wav/.mp3 error sound
terminalErrorSound.volume
number
1.0
Volume level (0.0 – 1.0)
terminalErrorSound.ignoredExitCodes
number[]
[130]
Exit codes to ignore (130 = Ctrl+C)
terminalErrorSound.detectOutputErrors
boolean
true
Scan terminal output in real-time for error patterns
terminalErrorSound.errorPatterns
string[]
(see below)
Text patterns that trigger the error sound
terminalErrorSound.debounceInterval
number
2000
Min milliseconds between consecutive sounds
📋 Commands
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and search for:
Terminal Error Sound: Toggle On/Off — quickly toggle the extension
Terminal Error Sound: Play Test Sound — preview the current error sound
🎧 Using a Custom Sound
Open Settings → search for terminalErrorSound
Set Custom Sound Path to the absolute path of your .wav or .mp3 file
Run Terminal Error Sound: Play Test Sound to verify
📝 Requirements
VS Code v1.93.0 or higher (required for Shell Integration API)
Shell integration must be enabled in your terminal (enabled by default in most shells)
