📖 Overview

Fahh Alert is a lightweight Visual Studio Code extension that automatically plays a customizable sound whenever a terminal command execution fails or exits with an error code.

Whether you're compiling code, running tests, or managing infrastructure, Fahh Alert ensures you get instant auditory feedback the moment something breaks. No more staring at the terminal waiting for builds to fail!

✨ Key Features

• 🎯 Instant Feedback: Instantly know when a process fails without taking your eyes off your code.
• 🎵 Fully Customizable Audio: Drop any .mp3, .wav, or .ogg file of your choice into the sounds/ directory to personalize your alert.
• 🎛️ Complete Control: Easily toggle the alert on/off and adjust the volume straight from your VS Code workspace settings.
• 🛠️ Built-in Testing: Preview your configured sound directly via the Command Palette by running Fahh Alert: Test Sound.

🚀 Getting Started

Prerequisites

• Visual Studio Code v1.93.0 or newer.
• Shell Integration must be active. (Note: VS Code enables this by default!)
• A system audio player:
  • macOS: Supported natively (afplay is built-in).
  • Windows: Supported natively (uses PowerShell fallback).
  • Linux: Requires mpg123, mplayer, or aplay to be installed on your system.

Quick Setup

1. Install the Fahh Alert extension.
2. (Optional) Want a custom sound? Add your .mp3, .wav, or .ogg file to the extension's sounds/ folder.
3. Update the fahhAlert.soundFile setting if you changed the filename from default.
4. Open the integrated terminal and run a command that intentionally fails.
5. Enjoy your satisfying feedback sound! 🔊

⚙️ Configuration

Tweak Fahh Alert to fit your exact workflow. Access these settings via Preferences: Open Settings (UI) and search for Fahh Alert.

👨‍💻 Development

Want to compile the extension yourself or contribute?

# 1. Install dependencies
npm install

# 2. Compile the TypeScript code
npm run compile

# 3. Watch for changes during development
npm run watch

Pro Tip: Press F5 in VS Code to quickly launch an Extension Development Host right in your workspace!