🎺 Faaaah You Failed

A fun VS Code / Cursor extension that plays a sad trombone sound every time your code crashes in the terminal!

Features

Automatic fail detection — listens for non-zero exit codes in your terminal
Multiple built-in sounds — Sad Trombone 🎺 or the iconic Faaaah! 😩
Funny roast messages — random roasts every time you fail
Status bar toggle — quickly turn it on/off from the bottom bar
Custom sound support — use your own .wav or .mp3 file
Settings panel — a polished WebView UI to configure everything

Commands

Command	Description
`Faaaah: Toggle Fail Sound On/Off`	Enable or disable the fail sound
`Faaaah: Test Fail Sound 🎺`	Test the sound right now
`Faaaah: Browse Custom Sound File 🎵`	Pick a custom `.wav` or `.mp3` file
`Faaaah: Open Settings ⚙️`	Open the settings panel

Settings

Setting	Default	Description
`faaaahYouFailed.enabled`	`true`	Master on/off switch
`faaaahYouFailed.showMessage`	`true`	Show funny roast messages
`faaaahYouFailed.selectedSound`	`"sad-trombone"`	Which sound to play (`sad-trombone`, `faaaah`, or `custom`)
`faaaahYouFailed.customSoundPath`	`""`	Path to a custom `.wav` or `.mp3` file

How It Works

The extension uses VS Code's Shell Integration API to detect when a terminal command exits with a non-zero exit code. When a failure is detected, it plays the selected fail sound and shows a random funny message.

Note: Shell Integration must be enabled in your terminal for the extension to detect failures (it's on by default in recent VS Code / Cursor versions).

Development & Maintenance

Project Structure

faaaah-you-failed/
├── src/                     ← Source code (edit these)
│   ├── extension.ts         ← Main logic (terminal listener, commands)
│   ├── audio-player.ts      ← Cross-platform sound playback
│   ├── sound-generator.ts   ← Generates the trombone WAV
│   └── settings-panel.ts    ← WebView settings UI
├── sounds/
│   └── fahh.mp3             ← Bundled "faaaah" sound
├── images/
│   └── icon.png             ← Extension icon
├── dist/                    ← Built output (auto-generated, don't edit)
├── package.json             ← Extension manifest (commands, settings, metadata)
└── .vscodeignore            ← What NOT to include in the published VSIX

Useful Commands

Task	Command
Build locally	`npm run compile`
Watch mode (auto-rebuild)	`npm run watch`
Package as VSIX	`npx @vscode/vsce package --allow-missing-repository`
Install VSIX locally	`cursor --install-extension <file>.vsix --force`
Publish update	`npx @vscode/vsce publish patch`
Check for lint errors	`npm run lint`

How to Push Updates

Make your code changes in the src/ folder
Bump the version in package.json:
- 0.0.1 → 0.0.2 — patch (bug fixes)
- 0.0.1 → 0.1.0 — minor (new features)
- 0.0.1 → 1.0.0 — major (breaking changes)
Update CHANGELOG.md with what changed

Publish the update to the marketplace:

npx @vscode/vsce publish

Or bump + publish in one command:

npx @vscode/vsce publish patch   # auto-bumps 0.0.1 → 0.0.2
npx @vscode/vsce publish minor   # auto-bumps 0.0.2 → 0.1.0

Commit & push to GitHub:

git add .
git commit -m "v0.0.2 - description of changes"
git push

Faaaah You Failed

Raafeh Sajjad