Telugu Fun Terminal Sound

A Visual Studio Code extension that plays notification sounds when terminal commands complete. Get audio feedback for successful command execution (exit code 0) or failures (non-zero exit codes).

Features

✨ Smart Notifications

• Play different sounds for successful (exit code 0) and failed (non-zero exit code) terminal commands
• 4 built-in sound options for both success and failure scenarios
• Fully configurable via VS Code settings

🎵 Cross-Platform Audio Support

• Windows: PowerShell audio playback
• macOS: Native afplay command
• Linux: PulseAudio (paplay) support

⚙️ Customizable Settings

• Choose individual sounds for success and failure notifications
• Adjustable volume level (0.0 to 1.0)
• Enable/disable the extension without uninstalling
• Window-level configuration scope

🧪 Test Commands

• Test success and failure sounds directly from the command palette
• Verify your audio setup without running actual commands

Installation

From VS Code Marketplace (Recommended)

Published on VS Code Marketplace

1. Open VS Code
2. Press Ctrl+Shift+X (or Cmd+Shift+X on macOS) to open Extensions
3. Search for "Telugu Fun Terminal Sound"
4. Click Install

Or install directly:

ext install LuffyDevOP.telugu-fun-terminal-sound

From Source

1. Clone this repository: git clone https://github.com/mohan13krishna/Telugu-Fun-Terminal-sounds.git
2. Install dependencies: npm install
3. Compile: npm run compile
4. Press F5 to run in debug mode

Configuration

Settings

Open VS Code Settings (Ctrl+, or Cmd+,) and search for "teluguFunTerminalSound":

{
  "teluguFunTerminalSound.successSound": "Sairam",
  "teluguFunTerminalSound.failureSound": "Gudiseti na kodaka",
  "teluguFunTerminalSound.enabled": true,
  "teluguFunTerminalSound.volume": 1.0
}

Available Sounds

Success (Exit Code 0):

• Sairam - Devotional Song (plays on success)

Failure (Non-Zero Exit Code) - Choose one:

• Gudiseti na kodaka - Traditional Folk
• Pilla bacha nayala - Village Song
• Sairam sairam - Classic Chant

Settings Descriptions

Usage

Automatic Sound Playback

Once installed, the extension automatically:

1. Monitors VS Code terminal activity
2. Detects when commands complete
3. Plays the appropriate sound based on exit code
4. Shows status message in the status bar

Test Sounds

Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and run:

• Telugu Fun Terminal Sound: Test Success Sound - Preview your configured success sound
• Telugu Fun Terminal Sound: Test Failure Sound - Preview your configured failure sound

Platform Compatibility

Troubleshooting

No Sound Playing

1. Check if extension is enabled: teluguFunTerminalSound.enabled should be true
2. Verify volume is not 0: teluguFunTerminalSound.volume should be > 0.0
3. Test sounds using commands from Command Palette
4. Check VS Code output log: View → Output → select extension output

Audio Issues on Linux

If sounds don't play on Linux:

# Install PulseAudio
sudo apt-get install pulseaudio

# For ALSA as fallback
sudo apt-get install alsa-utils

Permission Denied on macOS

If you get permission errors:

# Grant execute permissions
chmod +x /path/to/media/sound*.mp3

Development

Prerequisites

• Node.js 14+ and npm
• TypeScript 4.5+
• VS Code 1.60+

Setup

# Clone the repository
git clone https://github.com/yourusername/telugu-fun-terminal-sound.git
cd telugu-fun-terminal-sound

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode for development
npm run watch

Project Structure

telugu-fun-terminal-sound/
├── src/
│   └── extension.ts          # Main extension code
├── media/
│   ├── sound1.mp3            # Bell sound
│   ├── sound2.mp3            # Chime/Error sound
│   ├── sound3.mp3            # Ding/Warning sound
│   └── sound4.mp3            # Tada/Alert sound
├── images/
│   └── icon.png              # Extension icon
├── out/                       # Compiled output (generated)
├── package.json              # Extension manifest
├── tsconfig.json             # TypeScript configuration
├── README.md                 # This file
├── LICENSE                   # MIT License
└── .vscodeignore             # Files to exclude from extension

Running Locally

1. Open the project in VS Code
2. Press F5 to start debugging
3. A new VS Code window opens with the extension loaded
4. Open a terminal and run a command to test

Building for Production

# Install esbuild for bundling
npm install --save-dev esbuild

# Create production build
npm run vscode:prepublish

# This generates optimized out/extension.js

Publishing

Prerequisites

• npm account
• Azure DevOps account
• Visual Studio Marketplace account

Step-by-Step Publishing Guide

1. Create Publisher Account

# Login to or create account at https://marketplace.visualstudio.com/

# If creating new publisher through command line:
# (requires Personal Access Token from Azure DevOps)

2. Create Azure DevOps PAT (Personal Access Token)

1. Go to https://dev.azure.com
2. Sign in with Microsoft account
3. Click user settings (top right) → Personal access tokens
4. Click "New Token"
5. Set:
   • Name: "vsce-publisher"
   • Organization: "All accessible organizations"
   • Scopes: "Marketplace" → "Manage"
6. Copy the token (save it securely)

3. Install vsce (VS Code Extension Publisher CLI)

npm install -g vsce

4. Create Publisher (if new)

vsce create-publisher <publisher-name>

# Example:
vsce create-publisher MohanDev
# When prompted, paste your Azure DevOps PAT

5. Login with vsce

vsce login <publisher-name>

# Example:
vsce login MohanDev
# When prompted, paste your Azure DevOps PAT

6. Update Version

Edit package.json:

{
  "version": "1.0.1"
}

Increment version following Semantic Versioning:

• MAJOR.MINOR.PATCH (e.g., 1.0.0)
• MAJOR: Breaking changes
• MINOR: New features (backward compatible)
• PATCH: Bug fixes

7. Package Extension

# Create .vsix file
vsce package

# This generates: telugu-fun-terminal-sound-1.0.1.vsix

8. Publish to Marketplace

# Publish to VS Code Marketplace
vsce publish

# Or publish a pre-packaged .vsix
vsce publish --packagePath ./telugu-fun-terminal-sound-1.0.1.vsix

9. Update and Republish

To release a new version:

# 1. Make code changes
# 2. Update version in package.json
npm version patch    # or minor/major

# 3. Recompile
npm run vscode:prepublish

# 4. Commit changes
git add .
git commit -m "Release v1.0.1"
git push

# 5. Publish
vsce publish

Local Testing with .vsix

To test the packaged extension locally before publishing:

# 1. Package the extension
vsce package

# 2. In VS Code:
#    Extensions → Three dots menu → Install from VSIX
#    Select the generated .vsix file

# 3. Test all functionality
# 4. If issues, fix code and package again

Extension API Requirements

This extension uses the following VS Code APIs:

• vscode.window.onDidOpenTerminal - Detect new terminal creation
• vscode.window.onDidCloseTerminal - Detect terminal closure
• vscode.window.setStatusBarMessage - Show status messages
• vscode.workspace.getConfiguration - Read user configuration
• vscode.workspace.onDidChangeConfiguration - Listen to config changes
• vscode.commands.registerCommand - Register custom commands

License

This project is licensed under the MIT License. See LICENSE file for details.

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support & Feedback

• Report bugs: GitHub Issues
• Feature requests: GitHub Issues
• Email: your.email@example.com

Changelog

Version 1.0.0

• ✨ Initial release
• 🎵 Cross-platform audio support (Windows, macOS, Linux)
• ⚙️ Configurable sounds and volume
• 🧪 Test command support
• 📊 Status bar notifications

Made with ❤️ for productivity lovers 🎯