🚨 Sus Alert

That command lookin' kinda sus... ඞ
Automatically plays the iconic Among Us role reveal / imposter sound whenever a terminal command fails or returns a non-zero exit code!

Crafted with ❤️ by Anshul Bhilare

📖 Overview

Sus Alert is a lightweight Visual Studio Code extension that monitors your integrated terminal. The moment a build fails, a unit test crashes, or any command exits with an error code, Sus Alert triggers the dramatic Among Us role reveal sound (or customizable meme sounds) to notify you immediately.

No more staring at terminal logs waiting for long-running scripts to fail!

✨ Features

🎯 Instant Feedback: Connects directly to VS Code's native Shell Integration API to detect failed commands in real time.
🔊 Iconic Among Us Sound: Plays the authentic Among Us role reveal / imposter sound by default.
🎛️ Alternative Sound Presets:
- among-us: The classic Among Us role reveal sound (Default)
- bruh: Classic meme "Bruh" sound effect
- bonk: Cartoon bonk sound effect
- sad-trombone: Classic comedy fail ("Wah wah wah waaaah")
- error-chime: Clean digital alert chime
- custom: Drop any .mp3, .wav, or .ogg sound into the sounds/ directory or specify a custom path!
🎧 Native Cross-Platform Audio:
- Windows: Built-in support (WMPlayer.OCX & System.Media).
- macOS: Built-in support (afplay).
- Linux: Supports paplay, pw-play, aplay, ffplay, or mpg123.
🎚️ Volume & Status Bar Controls:
- Click $(megaphone) Sus Alert in your VS Code status bar for a quick menu to toggle on/off, adjust volume, or test sounds with one click.
⏱️ Cooldown Protection: Prevents multiple alerts from overlapping when commands fail repeatedly.
🏆 Optional Success Chime: Toggle susAlert.playOnSuccess to play a cheerful chime when commands exit successfully with code 0.

🚀 Getting Started

Prerequisites

Visual Studio Code v1.93.0 or newer.
Shell Integration: Active by default in VS Code!

Quick Usage

Open the integrated terminal (Ctrl + \`` or Cmd + ``).
Run any command that intentionally fails (e.g. cat non-existent-file or exit 1).
Enjoy your satisfying Among Us role reveal sound! ඞ

⚙️ Configuration Settings

Configure Sus Alert via Preferences > Settings (or press Ctrl+,) and search for Sus Alert.

Configuration Key	Type	Default	Description
`susAlert.enabled`	`boolean`	`true`	Master switch to enable or disable sound alerts on failure.
`susAlert.soundPreset`	`string`	`"among-us"`	Preset sound to play (`among-us`, `bruh`, `bonk`, `sad-trombone`, `error-chime`, `custom`).
`susAlert.soundFile`	`string`	`"among-us.mp3"`	Audio file name residing in the extension's `sounds/` folder.
`susAlert.customSoundPath`	`string`	`""`	Optional absolute path to an external `.mp3`, `.wav`, or `.ogg` file anywhere on your drive.
`susAlert.volume`	`number`	`1.0`	Controls audio playback volume (from `0.0` to `1.0`).
`susAlert.playOnSuccess`	`boolean`	`false`	Also play a cheerful chime when commands exit successfully with code 0.
`susAlert.cooldownMs`	`number`	`1000`	Minimum delay in milliseconds between alerts to prevent spam.
`susAlert.showStatusBar`	`boolean`	`true`	Show the Sus Alert icon in the bottom status bar.

⌨️ Command Palette Commands

Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and type:

Sus Alert: Test Sound: Previews the active alert sound.
Sus Alert: Toggle Enable / Disable: Quickly toggle the extension on or off.
Sus Alert: Select Sound Preset: Interactively switch between sounds with live preview.
Sus Alert: Set Volume: Choose volume level (100%, 80%, 60%, 40%, 20%, Mute).
Sus Alert: Open Sounds Folder: Open the extension's sounds/ directory in File Explorer to drop custom audio.
Sus Alert: Quick Menu: Interactive quick-access menu with all options.

📦 How to Upload to the VS Code Marketplace

Step 1: Package into a `.vsix`

Run in terminal: ```bash npm run package ``` This creates sus-alert-1.0.0.vsix.

Step 2: Install Locally Immediately

Open VS Code.
Press Ctrl + Shift + X (Extensions).
Click ... > Install from VSIX....
Choose sus-alert-1.0.0.vsix.

Step 3: Publish to Marketplace (Public Download for Everyone)

Go to the Visual Studio Marketplace Management Portal.
Sign in and create your Publisher (e.g. anshulbhilare).
Click New extension > Visual Studio Code and upload sus-alert-1.0.0.vsix. Within minutes, anyone across the world can find and install Sus Alert directly inside VS Code!

👨‍💻 Development

```bash

1. Install dependencies

npm install

2. Compile TypeScript

npm run compile

3. Watch for changes

npm run watch ```

Press F5 in VS Code to test in an Extension Development Host!

Sus Alert

Anshul Bhilare