Instantly know when your terminal commands fail with auditory feedback.
Terminal Tune turns terminal errors into helpful (or funny) sound alerts. Whether it's a "fart," an "Oh No!", or a custom sound of your choice, you'll never miss a failed build or a typo again—even when you're looking at another monitor.
✨ Features
🔊 Instant Feedback: Plays a sound the moment a terminal command returns a non-zero exit code.
🎼 Built-in Library: Choose from professional error tones or funny alerts like "Oh No!".
🛠️ Fully Customizable: Point the extension to any .wav file on your computer for a personalized experience.
🚀 Lightweight: Optimized to run in the background with zero performance impact.
🧪 Test Command: Easily preview your selected sound via the Command Palette.
🚀 Getting Started
Install the extension.
Open your terminal and run any command.
If a command fails (e.g., a typo like gti status), you will hear the Error Sound!
How to Add Own Sound Effect
Once the extension is installed, the user doesn't need to touch the code. They just:
Download or create a new .wav file (e.g., fart-sound.wav).
Save it anywhere on their computer (e.g., C:\Sounds\fart-sound.wav).
Open VS Code Settings (Ctrl + ,).
Find Terminal Tune: Custom Sound Path.
Paste the full path: C:\Sounds\fart-sound.wav.
Now, every time the terminal errors, it will play that custom sound!
Note: This extension requires Shell Integration to be enabled in VS Code (enabled by default in version 1.70+).
⚙️ Configuration
Customize Terminal Tune to fit your workflow. Go to Settings > Extensions > Terminal Tune:
Setting
Type
Default
Description
terminalTune.soundFile
Dropdown
error.wav
Select one of the built-in sounds (error, ohno, fail).
terminalTune.customSoundPath
String
""
Provide an absolute path to a custom .wav file to override the default.
⌨️ Commands
Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and type:
Terminal Tune: Play Test Sound — Previews the currently selected sound.
🛠️ Requirements
Windows: Supports .wav files natively.
macOS: Supports most audio formats via afplay.
Linux: Requires aplay (part of alsa-utils) to be installed.
🙌 Contributing & Support
Found a bug or have a feature request? Please open an issue on our GitHub Repository.
Enjoying Marker Pen? Consider leaving a ⭐ on the Marketplace!
