✨ Features
| Feature |
Description |
| 🔊 Failure Sound |
Plays FHAAAAA sound on any terminal command exit code ≠ 0 |
| 🎉 Success Sound |
Plays a victory sound when your command exits with code 0 |
| 🇮🇳 Indian Dev Memes |
Random desi meme popups — "Chai pi aur phir try kar", "7 Crore ka package pakka!" |
| 📊 Status Bar Counter |
Live fail count in the bottom status bar (green → orange → red) |
| ⚡ Per-Command Detection |
Fires after every command — no need to close the terminal |
| 🖥️ Cross-Platform |
macOS, Linux, and Windows all supported |
🔊 How It Works
FailScream listens to every command you run in VS Code's integrated terminal using the Shell Integration API. The moment a command finishes:
- Exit code 0 → 🎉 Success sound plays + a hype meme appears
- Exit code ≠ 0 → 💀 Failure sound plays + a roast meme appears
No need to close the terminal. Sounds fire the instant the command finishes.
| Platform |
Sound Engine |
Notes |
| macOS |
afplay (built-in) |
Works out of the box |
| Linux |
ffplay (ffmpeg) |
Run sudo apt install ffmpeg if needed |
| Windows |
PowerShell + WMP |
Requires Windows Media Player |
⚙️ Configuration
Open Settings (Ctrl+,) → search "FailScream" or add to settings.json:
{
// Master toggle (default: true)
"failScream.enabled": true,
// Volume 0.0 (silent) to 1.0 (full) — default: 0.5
"failScream.volume": 0.5,
// Custom failure sound — leave blank to use built-in
"failScream.soundPath": "",
// Play a success sound on exit code 0 (default: true)
"failScream.successEnabled": true,
// Custom success sound — leave blank to use built-in
"failScream.successSoundPath": "",
// Show Indian dev meme notifications (default: true)
"failScream.indianMemeMessages": true
}
🇮🇳 Meme Samples
On Failure 💀
- "Yaar, kya kar raha hai tu?"
- "Chai pi aur phir try kar."
- "Git blame se teri identity chhup nahi sakti."
- "DSA padha hota toh aaj yeh na hota."
On Success 🎉
- "7 Crore ka package pakka!"
- "FAANG wale dekh rahe hain tujhe!"
- "Desi jugaad wins again!"
- "Senior Dev level unlocked!"
📁 Project Structure
failscream/
├── media/
│ ├── icon.png # Extension icon
│ ├── fhaaa.mp3 # Failure alert sound
│ └── 7_crore.mp3 # Success sound
├── src/
│ ├── extension.ts # activate() / deactivate()
│ ├── terminalListener.ts # Command detection
│ ├── soundPlayer.ts # Cross-platform playback
│ └── config.ts # Settings helper
└── out/ # Compiled JavaScript
🚀 Development
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Watch mode (auto-recompile)
npm run watch
# Press F5 in VS Code to launch Extension Development Host
📦 Packaging
# Build the VSIX
npx vsce package
# Install locally
code --install-extension failscream-1.0.0.vsix
🤝 Contributing
Issues and PRs are welcome! Found a bug or want to add more memes?
→ Open an Issue
📄 License
MIT © ambaskaryash
