FAAAAH Error Sound

A Visual Studio Code extension that plays an audio alert whenever errors are detected in your workspace, helping you stay aware of issues as you code.

Features

The extension monitors your workspace and plays a sound when:

TypeScript compilation errors occur
ESLint linting errors are detected
Build processes fail
Test suites fail

Language Support: Works with all programming languages, not limited to JavaScript/TypeScript.

Installation

Open Visual Studio Code
Go to Extensions (press Ctrl+Shift+X or Cmd+Shift+X on Mac)
Search for "FAAAAH"
Click Install

Usage

Sound Toggle

The extension includes a mute/unmute toggle in the VS Code status bar (bottom right corner). Click the speaker icon to toggle sound notifications on or off without disabling the extension.

Volume Control

You can adjust the volume of the error sound from 0 (silent) to 100 (maximum). To change the volume:

Open VS Code Settings (Ctrl+, or Cmd+, on Mac)
Search for faaah
Find "Faaah: Volume" setting
Set your preferred volume level (default is 50)

The volume setting works on all supported platforms (Windows, macOS, and Linux).

Configuration

Available Settings

The following settings can be configured through VS Code settings or directly in your settings.json file:

Setting	Type	Default	Description
`faaah.enabled`	boolean	`true`	Enable or disable the extension
`faaah.muted`	boolean	`false`	Temporarily mute sounds without disabling the extension
`faaah.cooldownMs`	number	`1500`	Minimum delay between consecutive sounds (in milliseconds)
`faaah.volume`	number	`50`	Volume level for error sound (0-100)
`faaah.customSoundPath`	string	`""`	Path to a custom sound file (leave empty for default)

Setting a Custom Sound File

You can replace the default sound with your own audio file:

Open VS Code Settings (Ctrl+, or Cmd+, on Mac)
Search for faaah
Locate the "Faaah: Custom Sound Path" setting
Enter the full path to your custom sound file

Example paths:

Windows: C:\Users\YourName\sounds\myerror.mp3
Mac/Linux: /home/username/sounds/myerror.mp3

Supported audio formats: MP3, WAV, and other formats supported by your system.

Note: Leave this setting empty to use the default sound.

Configuration via settings.json

Alternatively, configure the extension directly in your settings.json file:

{
  "faaah.enabled": true,
  "faaah.muted": false,
  "faaah.cooldownMs": 1500,
  "faaah.volume": 50,
  "faaah.customSoundPath": ""
}

To access settings.json:

Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
Type "Preferences: Open User Settings (JSON)"
Add the configuration above

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Credits

Created by @monirweb

License

See LICENSE file for details.

Faaah Sound Errors

Monirweb