Faaah Terminal

A VS Code extension that plays a fun "faaahh" sound effect whenever you execute a command that fails (non-zero exit code) in the terminal!

Features

🔊 Automatic Sound Playback - Plays a fun sound whenever a terminal command exits with a non-zero exit code

• Works automatically in any terminal
• No configuration needed
• Activates on startup

🎵 Customizable Sound Effects - Choose from 9 different trendy sound effects:

• faaahh (default) - Classic descending tone
• discord_ping - Modern notification sound
• fart - Juvenile humor
• mario_power_down - Retro gaming classic
• minecraft_damage_sound - 8-bit nostalgia
• oh_noooo - Dramatic gasp
• vine_doom - Heavy aggressive sound
• windows_xp_error - Iconic system error
• wow - Peak meme culture

🎯 Cross-Platform Support

• macOS: Uses afplay
• Windows: Uses PowerShell's Media.SoundPlayer
• Linux: Supports paplay, aplay, or ffplay

How It Works

The extension monitors terminal shell executions using VS Code's shell integration feature. When a command completes with a non-zero exit code (indicating failure), it automatically:

1. Plays the "faaahh" sound effect
2. Shows a subtle notification message

Installation

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "Faaah Terminal"
4. Click Install

Alternatively, you can package and install this extension locally by running npm run vscode:prepublish and using the VSIX file.

Configuration

You can customize which sound plays when a command fails. Open VS Code Settings and search for "faaahTerminal.soundEffect" or edit your settings.json:

{
  "faaahTerminal.soundEffect": "discord_ping"
}

Available options: faaahh, discord_ping, fart, mario_power_down, minecraft_damage_sound, oh_noooo, vine_doom, windows_xp_error, wow

Default: faaahh

Known Issues

• Sound playback requires audio device and appropriate audio player installed on your system
• Some minimal shells might not have proper shell integration support
• The sound file is generated automatically during installation

Calling out known issues can help limit users opening duplicate issues against your extension.

Release Notes

Users appreciate release notes as you update your extension.

1.0.0

Initial release of ...

1.0.1

Fixed issue #.

1.1.0

Added features X, Y, and Z.

Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.

• Extension Guidelines

Working with Markdown

You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:

• Split the editor (Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
• Toggle preview (Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
• Press Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.

For more information

• Visual Studio Code's Markdown Support
• Markdown Syntax Reference

Enjoy!