Siuuuuu Terminal Success 🎉

A VS Code extension that plays a celebratory SIUUUUU sound whenever a command executes successfully in your terminal. Perfect for celebrating wins when you're multitasking!

Features

• 🎵 Automatically plays a sound when terminal commands complete successfully
• ❌ Error detection — sound is suppressed when errors are detected
• ⚙️ Configurable patterns — customize success/error detection patterns
• 🔊 Adjustable volume control
• 🎮 Easy toggle on/off
• 🧪 Test sound command to verify it's working
• 💻 Cross-platform — works on Windows, macOS, and Linux

How It Works

1. The extension monitors all terminal output using VS Code's onDidWriteTerminalData event
2. When terminal data arrives, it checks for error patterns (e.g., Error:, FAIL:, Exception)
3. After the terminal settles (800ms debounce), it checks if a shell prompt has returned
4. If a prompt is detected without any errors, it plays the sound file! 🎉
5. A configurable cooldown prevents sound spamming

Installation

From Source

1. Clone/download this extension folder
2. Add your sound file to the sounds/ directory (name it success.mp4, success.mp3, or success.wav)
3. Open VS Code
4. Go to Extensions → ... menu → Install from VSIX (after packaging)

Quick Install for Development

1. Open this folder in VS Code
2. Press F5 to launch Extension Development Host
3. Test in the new window!

Commands

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

Configuration

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

siuuuuuSuccess.enabled

• Type: boolean
• Default: true
• Enable/disable the siuuuuu sound on successful command execution

siuuuuuSuccess.volume

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

siuuuuuSuccess.successPatterns

• Type: array (regex patterns)
• Default:

[
  "\\$ $",
  "PS [A-Z]:\\\\.*>\\s*$",
  "❯\\s*$",
  "➜\\s*$",
  ">\\s*$"
]

• Patterns to detect when a shell prompt has returned (command finished)

siuuuuuSuccess.errorPatterns

• Type: array
• Default:

[
  "error:", "Error:", "ERROR:",
  "fail:", "FAIL:", "Failed",
  "fatal:", "FATAL:",
  "Exception", "Traceback",
  "command not found", "is not recognized",
  "Cannot find", "ENOENT", "EACCES",
  "Permission denied", "exit code 1",
  "npm ERR!", "SyntaxError",
  "TypeError", "ReferenceError"
]

• If any of these are detected, the sound will NOT play

siuuuuuSuccess.cooldownMs

• Type: number
• Default: 3000
• Range: 500 to 30000
• Cooldown between sound plays (in milliseconds)

Audio Requirements

Installing Audio Players (Linux)

# FFmpeg (recommended)
sudo apt-get install ffmpeg

# Or MPV
sudo apt-get install mpv

# Or VLC
sudo apt-get install vlc

Project Structure

siuuuuuextension/
├── extension.js          # Main extension code
├── package.json          # Extension manifest
├── sounds/
│   ├── success.mp4       # ← YOUR SOUND FILE GOES HERE
│   └── README.txt        # Instructions
├── .vscodeignore         # Files to exclude from package
└── README.md             # This file

Packaging

# Install vsce
npm install -g @vscode/vsce

# Package the extension
vsce package

# Install the .vsix in VS Code:
# Extensions → ... → Install from VSIX

Troubleshooting

Sound not playing?

1. ✅ Check that a sound file exists in sounds/ directory
2. ✅ Use "Siuuuuu: Test Sound" command to verify
3. ✅ Check the Output panel → select "Siuuuuu Success" for logs
4. ✅ Make sure system volume is not muted
5. ✅ On Windows, try WAV format for best compatibility

Sound plays on errors?

• Add more specific patterns to siuuuuuSuccess.errorPatterns

Sound plays too often?

• Increase siuuuuuSuccess.cooldownMs (e.g., to 5000)

Sound never plays?

• Your shell prompt might not match the default patterns
• Check siuuuuuSuccess.successPatterns and add your prompt pattern
• Check the Output panel logs to see what's happening

License

MIT License - Feel free to use and modify!

Changelog

1.0.0

• 🎉 Initial release
• Terminal success detection
• Error pattern filtering
• Configurable success/error patterns
• Volume control
• Toggle & test commands
• Cross-platform support (Windows, macOS, Linux)
• Cooldown to prevent spamming

Made with ❤️ for developers who want to celebrate every successful command! SIUUUUU! ⚽🎉