Bash Lasher
Your terminal failures deserve a soundtrack!
A VS Code extension that plays humorous, escalating sounds whenever a terminal command fails. Transform your coding mistakes into a gaming experience with sound packs, custom audio features, escalating rage modes, combo multipliers, achievements, and roast messages.
Features
- Bring Your Own Sounds: Easily drop your own
.mp3 or .wav files.
- 8 Themed Sound Packs:
Meme, Anime, Movie, Retro, Animal, Rage, Default, or Combine all packs.
- Escalating Rage Mode: Sound gets louder and more dramatic with consecutive errors.
- Fighting-Game Combos: Rapid consecutive errors trigger announcements (DOUBLE KILL, RAMPAGE!).
- Live Achievement System: Unlock milestones across your coding sessions.
- Roast Messages: 50+ funny messages (Mild, Medium, Savage) in your Status Bar.
- Boss Mode: Instantly mute the shame when your boss walks by.
- Time & Holiday Awareness: Context-aware comments based on time of day.
- Sound Roulette (Gacha): Every error is a gacha pull with rarity tiers.
💻 Using the Global NPM Version
Don't want to use VS Code? We also have a standalone Command Line interface!
- Install it globally:
npm install -g bash-lasher
- Run it as a wrapper around your failing scripts:
bash-lasher "npm run build"
- Set custom parameters directly from the command line:
bash-lasher -s savage --sound ./fail.mp3 "cargo run"
How to add and play Custom Sounds
- Open the Command Palette (
Ctrl+Shift+P or Cmd+Shift+P).
- Type
Bash Lasher: Open Media Folder and press Enter.
- Drop your
.mp3 and .wav files inside the custom folder (or create new folders).
- To activate them, press
Ctrl+Shift+P, type Bash Lasher: Browse Sound Packs, and select Your own custom sounds.
To preview the current sound:
- Use Command Palette (
Ctrl+Shift+P), type Bash Lasher: Preview Current Sound.
To toggle sound ON/OFF quickly:
- Use Command Palette (
Ctrl+Shift+P), type Bash Lasher: Toggle Sound On/Off.
To set sound mode (Random, Roulette, Sequential):
- Use Command Palette (
Ctrl+Shift+P), type Bash Lasher: Set Sound Mode.
To activate Boss Mode (Panic Mute):
- Use shortcut:
Ctrl+Shift+M (Windows/Linux) or Cmd+Shift+M (Mac).
- Or use Command Palette, type
Bash Lasher: Toggle Boss Mode.
To view your Error Stats and Achievements:
- Use Command Palette, type
Bash Lasher: Show Error Stats or Bash Lasher: Show Achievements.
Configuration
Make sure you configure the extension to fit your play style. You can edit these in your settings.json or the VS Code Settings UI.
To set the working sound pack:
{
"bashLasher.soundPack": "random"
}
(Supported values: "random", "default", "meme", "anime", "movie", "animal", "retro", "rage", "custom")
To set an external folder for custom sounds:
{
"bashLasher.customSoundFolder": "C:\\MyMusic\\FailSounds"
}
To configure sound selection mode:
{
"bashLasher.mode": "roulette"
}
(Supported values: "single", "random", "sequential", "roulette")
To enable or disable Fighting-Game Combos:
{
"bashLasher.comboMode": true,
"bashLasher.comboAnnouncer": "mortal-kombat"
}
(Announcers: "fps", "street-fighter", "mortal-kombat")
To set Rage Mode configurations:
{
"bashLasher.rageMode": true,
"bashLasher.maxRageLevel": 5,
"bashLasher.rageResetTime": 60000
}
To configure Roast Messages severity:
{
"bashLasher.roastMode": true,
"bashLasher.roastSeverity": "savage"
}
(Severity: "mild", "medium", "savage")
Dependencies
- music-metadata: Under the hood, we use this to parse MP3/WAV durations dynamically.
- Uses native OS audio players (PowerShell
PresentationCore/System.Media.SoundPlayer on Windows, afplay on macOS, and mpg123/aplay on Linux). No bulky binary dependencies are shipped!
Change Log
See CHANGELOG.md here.
Issues
Submit issues on the GitHub repository if you find any bugs or have feature suggestions.
Star the repo!
If you like this extension, please give it a ⭐ on GitHub.
Contribution
Fork the repo and submit pull requests for new sound packs or roasting algorithms!
