Error Pro

Your Error Drama Alarm for VS Code

Never miss errors in your editor. Error Pro plays instant alerts for terminal failures and editor diagnostics, with one-click status bar controls.

Overview

Error Pro 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 an easy-to-use custom sound file picker via Command Palette
• 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
• Terminal detection mode control: output match, non-zero exit code, or either
• 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
• Built-in false-positive preset packs for common noisy output
• Settings import/export (JSON) for backups or sharing
• Compatibility status command with full/partial/unavailable terminal host reporting
• 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.

1. In VS Code, click Faah Off, Faah T, Faah E, or Faah T+E in the bottom bar.
2. Choose what you want: turn Faah on/off, select terminal/editor/both, switch error mode, snooze alerts, set quiet hours, select custom sound, play test sound, or open full settings.
3. Settings auto-save instantly in the Control Room; use the schedule presets, compatibility button, or import/export buttons for explicit actions.

Faah also applies a tiny shared cross-source guard window so a terminal error and a diagnostics error fired at nearly the same moment do not double-play two alerts back-to-back. In Control Room, you can also switch terminal detection mode and enable built-in false-positive preset packs.

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: Select Custom Sound
• Faah: Show Compatibility Status (raises host compatibility info)

🔊 Custom Sound

Error Pro plays the built-in faah sound by default. You can replace it with any audio file on your machine in two ways:

Method 1 — File Picker (Recommended)

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run Error Pro: Select Custom Sound
3. A file browser will open — choose any .wav, .mp3, .ogg, .aac, or .m4a file
4. The selected sound will play immediately as a preview
5. Done! Your custom sound is now saved and will play on every error alert

You can also access this from the Status Bar → click the Error Pro indicator → Select Custom Sound

Method 2 — Manual Path (settings.json)

1. Open VS Code Settings (Ctrl+,)
2. Search for faah.customSoundPath
3. Enter the absolute path to your audio file, for example:
   • Windows: C:\Users\YourName\sounds\alert.wav
   • macOS/Linux: /home/yourname/sounds/alert.wav
   • Home shorthand: ~/sounds/alert.wav

Reverting to Default

To go back to the built-in faah sound:

• Run Error Pro: Select Custom Sound and cancel, or
• Clear the faah.customSoundPath setting (set it to an empty string)

Supported Formats

Tip: .wav files are the most universally compatible across all platforms.

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

• Aakash Rajbanshi

License

MIT License