Faah - Error Alerts
Your Error Drama Alarm for VS Code
Never miss errors in your editor. Faah plays instant alerts for terminal failures and editor diagnostics, with one-click status bar controls.
For more: Faah Official Docs
Overview
Faah is a lightweight VS Code extension that listens for errors and plays a meme sound when they appear.
Default sound is faah, and you can optionally upload/select a custom sound file.
No more silent failures.
No more unnoticed broken builds.
No more cursed error output.
If your errors get dramatic — Faah gets louder.
Features
- Plays
faah by default, with optional uploaded custom sound override
- Lightweight and fast, with regex-based error detection and configurable patterns/excludes
- Separate cooldown controls for terminal and diagnostics sources
- Terminal and editor diagnostics source toggles with diagnostics severity mode
- Snooze controls (
15m, 30m, 1h, 2h) and clear snooze action
- Quiet hours presets plus custom
HH:mm ranges
- Visual alerts (warning popups) plus audio for every alert
- Quick presets (Balanced, Quiet, Aggressive) to snap into a mood
- Settings import/export (JSON) for backups or sharing
- Compatibility status command and notice when terminal monitoring is unavailable
- Workspace-aware settings (
faah.*) with auto-save Control Room UI
- Status bar indicator with source-aware quick actions
Configuration
Use Faah from the status bar quick actions or Command Palette.
- In VS Code, click
Faah Off, Faah T, Faah E, or Faah T+E in the bottom bar.
- Choose what you want: turn Faah on/off, select terminal/editor/both, switch error mode, snooze alerts, set quiet hours, play test sound, or open full settings.
- Settings auto-save instantly in the Control Room; use the schedule presets, compatibility button, or import/export buttons for explicit actions.
Command Palette commands:
Faah: Show Quick Actions
Faah: Open Settings
Faah: Play Test Sound
Faah: Snooze Alerts
Faah: Clear Snooze
Faah: Set Quiet Hours
Faah: Show Compatibility Status (raises host compatibility info)
Use Case
Faah is perfect when you:
- Run long tasks
- Work with noisy logs
- Switch tabs while working
- Miss subtle error messages
- Want dramatic feedback while coding 😄
Philosophy
Coding is already dramatic.
Faah just makes sure you hear it.
Authors
License
MIT License
Contributing
Contributions are welcome! Please feel free to submit an issue or a pull request.
Support
If you have any questions or feedback, please feel free to contact me at hello@kiron.dev.