Maakabhosraaag Error on Terminal 🔊

A VS Code extension that plays a "maakabhosraaag" sound whenever an error appears in your terminal. Perfect for catching errors when you're multitasking!

Features

🎵 Automatically plays a sound when terminal errors are detected
⚙️ Configurable error patterns to match
🔊 Adjustable volume control
🎮 Easy toggle on/off
🧪 Test sound command to verify it's working

Installation

Open VS Code
Press Ctrl+P to open Quick Open

Paste the following command and press Enter:

ext install Zubair.maakabhosraaag-terminal-error

Done! The extension will activate automatically.

Commands

Maakabhosraaag: Toggle Error Sound - Enable/disable the sound
Maakabhosraaag: Test Sound - Play the sound to test it's working

Access commands via Command Palette (Ctrl+Shift+P or Cmd+Shift+P)

Configuration

Open VS Code settings and search for "Maakabhosraaag" to configure:

`maakabhosraaagError.enabled`

Type: boolean
Default: true
Description: Enable/disable the maakabhosraaag sound on terminal errors

`maakabhosraaagError.volume`

Type: number
Default: 0.5
Range: 0.0 to 1.0
Description: Volume level for the maakabhosraaag sound

`maakabhosraaagError.errorPatterns`

Type: array

Default:

[
  "error:",
  "Error:",
  "ERROR:",
  "fail:",
  "FAIL:",
  "Failed",
  "fatal:",
  "FATAL:",
  "Exception",
  "Traceback"
]

Description: Patterns to detect errors in terminal output

Audio Player Requirements

The extension uses system audio players to play sounds:

Linux: Requires paplay (PulseAudio), aplay (ALSA), or ffplay (FFmpeg)
macOS: Uses built-in afplay (✅ Works out of the box)
Windows: Uses PowerShell's SoundPlayer (✅ Works out of the box with WAV format)

Installing Audio Players (Linux)

If you don't have an audio player installed:

# For Ubuntu/Debian (PulseAudio)
sudo apt-get install pulseaudio-utils

# For ALSA
sudo apt-get install alsa-utils

# For FFmpeg
sudo apt-get install ffmpeg

Packaging the Extension

To package and install the extension:

Install vsce (VS Code Extension Manager):
```
npm install -g @vscode/vsce
```
Package the extension:
```
vsce package
```
Install the .vsix file:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Click the "..." menu → "Install from VSIX"
- Select the generated .vsix file

Publishing (Optional)

To publish to the VS Code Marketplace:

Create a publisher account at https://marketplace.visualstudio.com/
Update publisher in package.json
Run:
```
vsce publish
```

How It Works

The extension monitors all terminal output using VS Code's onDidWriteTerminalData event
When terminal data is written, it checks against configured error patterns
If an error pattern is matched, it plays the sound file
The sound is played using system audio players (platform-specific)

Troubleshooting

Sound not playing?

Check the sound file exists: Make sure sounds/makabhosda_aag.mp3 exists
Test the sound: Use the "Maakabhosraaag: Test Sound" command
Check audio player: Ensure you have a compatible audio player installed (see requirements)
Check system volume: Make sure your system volume is not muted
Check extension logs: Open Output panel → select "Maakabhosraaag Error"

Too many false positives?

Adjust the maakabhosraaagError.errorPatterns setting to be more specific to your needs.

Sound too loud/quiet?

Adjust the maakabhosraaagError.volume setting (0.0 to 1.0).

Development

Project Structure

Maakabhosraaag extension/
├── extension.js          # Main extension code
├── package.json          # Extension manifest
├── sounds/
│   ├── makabhosda_aag.mp3         # Your sound file
│   └── README.txt       # Instructions
└── README.md            # This file

Testing

Open the extension folder in VS Code
Press F5 to start debugging
Test in the Extension Development Host window

License

MIT License - Feel free to use and modify!

Contributing

Contributions are welcome! Feel free to:

Add new features
Improve error detection
Add support for more audio formats
Report bugs or issues

Changelog

1.1.3

Updated: New error sound effect

1.1.2

New: Added extension icon/logo
Improved: Visual branding for marketplace listing

1.1.1

Fixed: Added terminalDataWriteEvent to API proposals to resolve activation error
Fixed: Extension now properly declares all required proposed APIs
Improved: Better compatibility with VS Code stable releases

1.1.0

New: Windows support added! Now works on Windows, macOS, and Linux
New: Includes WAV audio file for Windows compatibility (PowerShell SoundPlayer requires WAV format)
Improved: Automatically selects correct audio format based on platform (MP3 for Linux/Mac, WAV for Windows)
Fixed: Resolved audio playback issues on Windows systems

1.0.0

Initial release
Terminal error detection
Configurable error patterns
Volume control
Toggle command
Test sound command

Made with ❤️ for developers who want audible error notifications!