🐱 Laughing Cat Error Sounds by Sanjana

Never silently miss a failed terminal command again. The laughing cat will let you know. 🔊

✨ Features

💻 Terminal Command Failures

Whenever a terminal command exits with a non-zero exit code — meaning it failed — the sound plays automatically. No more staring at a terminal that quietly errored out while you weren't looking.

npm run build   # fails → 🔊 sound plays
git push        # fails → 🔊 sound plays  
python app.py   # crashes → 🔊 sound plays

⏱ Smart Cooldown (Debounce)

A built-in 2 second cooldown prevents sound spam. If multiple errors fire at once, you only hear one sound.

🔕 One-Click Toggle

A bell icon in your status bar lets you mute/unmute instantly without touching any settings.

🔊 Custom Sound Support

Don't like the built-in sound? Point it to any .wav file on your machine.

🍎🐧🪟 Works on All Platforms

Windows — PowerShell audio player
macOS — afplay (built-in)
Linux — aplay / paplay

🚀 Getting Started

Install the extension
Open a terminal in VS Code
Run any failing command:

npm run thiscommanddoesnotexist

🔊 You'll hear the sound!

To verify it works immediately, open the Command Palette (Ctrl+Shift+P) and run:

Error Sound: Play Test Sound

⚙️ Settings

Open settings.json (Ctrl+Shift+P → "Open User Settings JSON") and customize:

{
  "errorSound.enabled": true,
  "errorSound.terminal.enabled": true,
  "errorSound.diagnostics.enabled": false,
  "errorSound.cooldownMs": 2000,
  "errorSound.volume": 1.0,
  "errorSound.customSoundPath": ""
}

Setting	Default	Description
`errorSound.enabled`	`true`	Master on/off switch
`errorSound.terminal.enabled`	`true`	Sound on terminal failures
`errorSound.diagnostics.enabled`	`false`	Sound on red squiggle errors (off by default)
`errorSound.cooldownMs`	`2000`	Cooldown between sounds in ms
`errorSound.volume`	`1.0`	Volume 0.1–1.0 (macOS only)
`errorSound.customSoundPath`	`""`	Path to your own `.wav` file

💡 Tip: errorSound.diagnostics.enabled is off by default because it can be noisy while actively typing code. Terminal errors are the most useful trigger.

⌨️ Commands

Command	Description
`Error Sound: Toggle On/Off`	Mute / unmute globally
`Error Sound: Play Test Sound`	Test the sound immediately

❓ FAQ

Q: Terminal errors aren't triggering the sound?
Make sure shell integration is enabled in your settings:

"terminal.integrated.shellIntegration.enabled": true

Then fully restart VS Code.

Q: Can I use my own sound?
Yes! Set errorSound.customSoundPath to the absolute path of any .wav file.

Q: Why no sound on Linux?
Install alsa-utils (sudo apt install alsa-utils) or PulseAudio.

👩‍💻 About the Developer

Made by Sanjana Dissanayake — a passionate developer who got tired of missing terminal errors quietly failing in the background.


🌐 Portfolio	sanjana-dissanayake.vercel.app
🐙 GitHub	github.com/sanjanadissa
💼 LinkedIn	linkedin.com/in/sanjana-dissanayake-b04963302

📄 License

If this extension helped you, please ⭐ rate it on the marketplace!

Laughing Cat Error Sounds by Sanjana

sanjanadissa123