{"_id":"@aicronic/terminal-buzz","_rev":"3-82e418189f59af444b97c81d0efd3884","name":"@aicronic/terminal-buzz","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@aicronic/terminal-buzz","version":"1.0.0","keywords":["cli","notifications","games","fun","productivity","terminal","sound","retro","gaming"],"author":{"name":"aicronic"},"license":"MIT","_id":"@aicronic/terminal-buzz@1.0.0","maintainers":[{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"}],"homepage":"https://github.com/aicronic/terminal-buzz#readme","bugs":{"url":"https://github.com/aicronic/terminal-buzz/issues"},"bin":{"game-notify":"bin/cli.js"},"dist":{"shasum":"890063eabe313bb6c13ae151118d00de9df5b0d1","tarball":"https://registry.npmjs.org/@aicronic/terminal-buzz/-/terminal-buzz-1.0.0.tgz","fileCount":17,"integrity":"sha512-miWwi1+exVKNdqe9+4bcImwNg90BzVWwIOpI8Wx5Isxb7f8bB0r5s7EyeV5dNHxqkm56ZAhUx/Gx8Int82H1EQ==","signatures":[{"sig":"MEYCIQC7AeQFN72ClzkQzQutmHG3iw19u8IVMTCXDgBjAd/PtgIhALq6Dr8mkczy+iW7Po1gPM57OAs5TjKdXYJuvXj16IwL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":253554},"main":"lib/index.js","engines":{"node":">=14.0.0"},"scripts":{"test":"node bin/cli.js --theme mario 'echo \"Test successful\"'","test-error":"node bin/cli.js --theme mario 'exit 1'"},"_npmUser":{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"},"repository":{"url":"git+https://github.com/aicronic/terminal-buzz.git","type":"git"},"_npmVersion":"10.9.3","description":"CLI tool that plays nostalgic game sounds when commands finish - Make your terminal delightful again 🎮","directories":{},"_nodeVersion":"22.18.0","dependencies":{"conf":"^10.2.0","chalk":"^4.1.2","commander":"^11.0.0","play-sound":"^1.1.6","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/terminal-buzz_1.0.0_1770969647661_0.4908277948307862","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aicronic/terminal-buzz","version":"1.0.1","keywords":["cli","notifications","games","fun","productivity","terminal","sound","retro","gaming"],"author":{"name":"aicronic"},"license":"MIT","_id":"@aicronic/terminal-buzz@1.0.1","maintainers":[{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"}],"homepage":"https://github.com/aicronic/terminal-buzz#readme","bugs":{"url":"https://github.com/aicronic/terminal-buzz/issues"},"bin":{"terminal-buzz":"bin/cli.js"},"dist":{"shasum":"821d63ab6baadb118b38b8826e223d6715c6d57a","tarball":"https://registry.npmjs.org/@aicronic/terminal-buzz/-/terminal-buzz-1.0.1.tgz","fileCount":17,"integrity":"sha512-doTNGloOPfG+usuWwcuFUkcGl6k5c++VenspGgA0+mWIS5tTawjCp+1TFuIK0LjTdIMrnzfKjVNWIE6sRkbmig==","signatures":[{"sig":"MEUCIEjrmNWJvUrOnMR/ihUshwpMnyLBewKi0YOuJ8z6JgKQAiEAvUn5BrH94qoBabncJyOkDfjoTQwtl+X7y8jGGcrArnE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":253652},"main":"lib/index.js","engines":{"node":">=14.0.0"},"gitHead":"20513813da42c7dbb7df8acaf56d3bbebc359013","scripts":{"test":"node bin/cli.js --theme mario 'echo \"Test successful\"'","test-error":"node bin/cli.js --theme mario 'exit 1'"},"_npmUser":{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"},"repository":{"url":"git+https://github.com/aicronic/terminal-buzz.git","type":"git"},"_npmVersion":"10.9.3","description":"CLI tool that plays nostalgic game sounds when commands finish - Make your terminal delightful again 🎮","directories":{},"_nodeVersion":"22.18.0","dependencies":{"conf":"^10.2.0","chalk":"^4.1.2","commander":"^11.0.0","play-sound":"^1.1.6","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/terminal-buzz_1.0.1_1770970243556_0.13616633306630055","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@aicronic/terminal-buzz","version":"1.0.3","description":"CLI tool that plays nostalgic game sounds when commands finish - Make your terminal delightful again 🎮","main":"lib/index.js","bin":{"terminal-buzz":"bin/cli.js"},"keywords":["cli","notifications","games","fun","productivity","terminal","sound","retro","gaming"],"author":{"name":"aicronic"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aicronic/terminal-buzz.git"},"engines":{"node":">=14.0.0"},"dependencies":{"commander":"^11.0.0","play-sound":"^1.1.6","node-notifier":"^10.0.1","chalk":"^4.1.2","conf":"^10.2.0"},"devDependencies":{},"scripts":{"test":"node bin/cli.js --theme mario 'echo \"Test successful\"'","test-error":"node bin/cli.js --theme mario 'exit 1'"},"_id":"@aicronic/terminal-buzz@1.0.3","gitHead":"98cf13d861618805efc801b9dccb1b14eefde340","bugs":{"url":"https://github.com/aicronic/terminal-buzz/issues"},"homepage":"https://github.com/aicronic/terminal-buzz#readme","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-IPH420ocWOhrQ9aiRSXZJxDCwAWXFdq60PduLddIY63JLvbQ2JIr0aQ8piqcJO6HvOA/1y0oxJNtxgb4zbOAvg==","shasum":"23b945c9589f3092e9bf136e8a8ebe3ea48b7efe","tarball":"https://registry.npmjs.org/@aicronic/terminal-buzz/-/terminal-buzz-1.0.3.tgz","fileCount":17,"unpackedSize":257307,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEZ2kg/IQ4DSpBg8OmqVx2xPUpE1ozKHN3wA2aRYevA8AiEAk+SvO4tPSltqFMYONEtFz77BhZ+AM8+tIz7gPcdOSow="}]},"_npmUser":{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"},"directories":{},"maintainers":[{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/terminal-buzz_1.0.3_1771861415308_0.6328371066352196"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-13T08:00:47.076Z","modified":"2026-02-23T15:43:35.607Z","1.0.0":"2026-02-13T08:00:47.861Z","1.0.1":"2026-02-13T08:10:43.736Z","1.0.3":"2026-02-23T15:43:35.505Z"},"bugs":{"url":"https://github.com/aicronic/terminal-buzz/issues"},"author":{"name":"aicronic"},"license":"MIT","homepage":"https://github.com/aicronic/terminal-buzz#readme","keywords":["cli","notifications","games","fun","productivity","terminal","sound","retro","gaming"],"repository":{"type":"git","url":"git+https://github.com/aicronic/terminal-buzz.git"},"description":"CLI tool that plays nostalgic game sounds when commands finish - Make your terminal delightful again 🎮","maintainers":[{"name":"aicronic","email":"rishabh.bhardwaz95@gmail.com"}],"readme":"# 🎮 Terminal Buzz\n\n**Make your terminal delightful again!** \n\nA fun CLI tool that plays nostalgic game sounds when your terminal commands finish. Turn boring command-line tasks into a gaming experience!\n\n![npm version](https://img.shields.io/npm/v/@aicronic/terminal-buzz)\n![license](https://img.shields.io/npm/l/@aicronic/terminal-buzz)\n![downloads](https://img.shields.io/npm/dt/@aicronic/terminal-buzz)\n\n## ✨ Features\n\n- 🔊 **Nostalgic Game Sounds** - Success and error sounds from your favorite retro games\n- 🔔 **Desktop Notifications** - Get notified when long-running commands complete\n- 🎨 **Multiple Themes** - Mario, Zelda, Pokemon, Sonic, and Retro arcade sounds\n- ⚙️ **Configurable** - Set your default theme and preferences\n- 🎲 **Random Mode** - Surprise yourself with a different theme each time\n- 🤫 **Silent Mode** - Notifications only, no sound\n- 🎯 **Real-time Output** - See command output as it happens\n- 🛡️ **Graceful Interruption** - Ctrl+C works as expected\n\n## 📦 Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @aicronic/terminal-buzz\n```\n\n### Local Installation\n\n```bash\nnpm install @aicronic/terminal-buzz\n```\n\n## 🚀 Quick Start\n\n```bash\n# Run a command with Mario theme\nterminal-buzz --theme mario \"npm run build\"\n\n# Set your default theme\nterminal-buzz config set-theme zelda\n\n# Use your default theme\nterminal-buzz \"cargo build --release\"\n\n# Random theme each time\nterminal-buzz --random \"python train.py\"\n\n# Silent mode (notification only)\nterminal-buzz --silent \"npm test\"\n```\n\n## 🎮 Available Themes\n\n| Theme | Success Sound | Error Sound | Emoji |\n|-------|--------------|-------------|-------|\n| **🍄 Mario** | Coin collect | Game over | 🍄 |\n| **⚔️ Zelda** | Chest open | Error beep | ⚔️ |\n| **⚡ Pokemon** | Level up | Pokemon faint | ⚡ |\n| **💨 Sonic** | Ring collect | Death | 💨 |\n| **👾 Retro** | Pac-Man eat | Pac-Man death | 👾 |\n\n## 📖 Usage\n\n### Basic Command Execution\n\n```bash\nterminal-buzz [options] \"<your-command>\"\n```\n\n### Options\n\n| Option | Alias | Description |\n|--------|-------|-------------|\n| `--theme <name>` | `-t` | Override default theme (mario, zelda, pokemon, sonic, retro) |\n| `--random` | `-r` | Use a random theme |\n| `--silent` | `-s` | Notification only, no sound |\n| `--version` | `-V` | Show version number |\n| `--help` | `-h` | Display help |\n\n### Configuration Commands\n\n```bash\n# Set default theme\nterminal-buzz config set-theme <theme>\n\n# Get current default theme\nterminal-buzz config get-theme\n\n# List all available themes\nterminal-buzz config list-themes\n```\n\n## 💡 Use Cases\n\n### Long-Running Builds\n```bash\nterminal-buzz \"npm run build\"\nterminal-buzz \"cargo build --release\"\nterminal-buzz \"docker build -t myapp .\"\n```\n\n### Test Suites\n```bash\nterminal-buzz --theme pokemon \"npm test\"\nterminal-buzz \"pytest tests/\"\nterminal-buzz \"go test ./...\"\n```\n\n### Deployment Scripts\n```bash\nterminal-buzz --theme sonic \"npm run deploy\"\nterminal-buzz \"./deploy.sh production\"\n```\n\n### Training ML Models\n```bash\nterminal-buzz --random \"python train.py --epochs 100\"\n```\n\n### Database Operations\n```bash\nterminal-buzz \"pg_dump mydb > backup.sql\"\nterminal-buzz \"mongorestore --db mydb dump/\"\n```\n\n## 🎯 Real-World Examples\n\n```bash\n# Frontend development\nterminal-buzz --theme mario \"npm run build && npm run deploy\"\n\n# Backend compilation\nterminal-buzz --theme sonic \"go build -o server cmd/main.go\"\n\n# Data processing\nterminal-buzz --random \"python process_data.py --input large_dataset.csv\"\n\n# System administration\nterminal-buzz --silent \"rsync -avz /source/ /backup/\"\n\n# Multiple commands\nterminal-buzz \"npm install && npm run build && npm test\"\n```\n\n## 🌐 Global Shell Integration (Recommended)\n\nWant sounds after **every** command without typing `terminal-buzz`? Let the setup wizard handle it!\n\n```bash\nterminal-buzz setup\n```\n\nThis will automatically detect your shell (Bash or Zsh) and add the necessary hook to your config file.\n\n### Manual Integration\nIf the setup doesn't detect your shell, you can add these manually:\n\n**Bash (`~/.bashrc`):**\n```bash\nPROMPT_COMMAND='terminal-buzz --notify $? &'\n```\n\n**Zsh (`~/.zshrc`):**\n```bash\nprecmd() {\n  terminal-buzz --notify $? &!\n}\n```\n\n## 🔧 Configuration\n\nConfiguration is stored in `~/.config/terminal-buzz-config.json` (or platform equivalent).\n\nDefault configuration:\n```json\n{\n  \"theme\": \"mario\"\n}\n```\n\n## 🎨 Adding Custom Themes\n\nWant to contribute a new theme? Here's how:\n\n1. Create a new folder in `sounds/` with your theme name\n2. Add two MP3 files:\n   - `success.mp3` - Plays on successful command completion (exit code 0)\n   - `error.mp3` - Plays on command failure (non-zero exit code)\n3. Keep files under 50KB each for fast loading\n4. Update `lib/index.js` to include your theme in the `THEMES` object\n5. Submit a pull request!\n\n### Sound Requirements\n- Format: MP3\n- Bitrate: 64kbps recommended\n- Duration: 1-3 seconds\n- Size: < 50KB per file\n- License: Must be free to use (CC0, public domain, or similar)\n\n## 🛠️ Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/aicronic/terminal-buzz.git\ncd terminal-buzz\n\n# Install dependencies\nnpm install\n\n# Make CLI executable\nchmod +x bin/cli.js\n\n# Test locally\nnode bin/cli.js --theme mario \"echo 'Hello World'\"\n\n# Test error handling\nnode bin/cli.js --theme mario \"exit 1\"\n```\n\n## 🧪 Testing Checklist\n\n- ✅ Success sound plays on exit code 0\n- ✅ Error sound plays on non-zero exit code\n- ✅ Desktop notification appears\n- ✅ Config persists between runs\n- ✅ Ctrl+C kills both tool and child process\n- ✅ Command output streams in real-time\n- ✅ Works on Mac/Linux/Windows\n- ✅ Fallback to system beep if audio fails\n\n## 🌍 Platform Support\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| **macOS** | ✅ Full Support | Native audio and notifications |\n| **Linux** | ✅ Full Support | Requires `alsa-utils` or `pulseaudio` |\n| **Windows** | ✅ Full Support | Native audio via Windows Media Player |\n\n### Linux Audio Setup\n\nIf you encounter audio issues on Linux, install one of these:\n\n```bash\n# Ubuntu/Debian\nsudo apt-get install alsa-utils\n\n# Or use PulseAudio\nsudo apt-get install pulseaudio\n```\n\n## 📝 License\n\nMIT © [aicronic](https://github.com/aicronic)\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. Here are some ideas:\n\n- 🎵 Add new game themes\n- 🐛 Fix bugs or improve error handling\n- 📚 Improve documentation\n- ✨ Suggest new features\n\n## 🙏 Credits\n\nSound effects sourced from:\n- [The Mushroom Kingdom](https://themushroomkingdom.net/) - Mario sounds\n- [Zelda Dungeon](https://www.zeldadungeon.net/) - Zelda sounds\n- [Sounds Resource](https://www.sounds-resource.com/) - Sonic sounds\n- [Mixkit](https://mixkit.co/) - Free game sound effects\n- [Freesound](https://freesound.org/) - CC0 licensed sounds\n\n## ⭐ Show Your Support\n\nIf you find this tool useful, please consider:\n- ⭐ Starring the repository\n- 🐦 Sharing on social media\n- 🐛 Reporting bugs\n- 💡 Suggesting new features\n\n## 📬 Contact\n\n- GitHub: [@aicronic](https://github.com/aicronic)\n- Issues: [GitHub Issues](https://github.com/aicronic/terminal-buzz/issues)\n\n---\n\n**Made with ❤️ and nostalgia by developers, for developers**\n\n*Remember: Every successful build deserves a victory sound! 🎮*\n","readmeFilename":"README.md"}