CoinsCLI

.bashrc Audible Feedback Enhancer
Enhance your terminal experience with cool chimes and audible feedback for processes, scripts, and commands. This project provides a customizable .bashrc configuration that plays sounds to notify you of events in your terminal, making your workflow more interactive and fun.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

This repository contains a .bashrc configuration that adds audible feedback to your terminal. Whenever you run scripts, commands, or processes, you'll hear chimes or sounds that indicate success, failure, or completion. It's a great way to get instant, hands-free feedback while working in the terminal.

(back to top)

Built With

.bashrc

(back to top)

Getting Started

To get started, simply copy the provided .bashrc file to your home directory or append its contents to your existing .bashrc. This will enable audible feedback for your terminal sessions.

Prerequisites

You will need:

• A Bash-compatible terminal (e.g., Git Bash, WSL, Linux, macOS Terminal)
• A system with audio playback capability

Installation

1. Clone or download this repository.
2. Copy the .bashrc file to your home directory, or append its contents to your existing .bashrc:

cat .bashrc >> ~/.bashrc

3. Restart your terminal or run source ~/.bashrc to apply the changes.

(back to top)

Usage

Once installed, use your terminal as usual. When you run commands, scripts, or processes, you'll hear chimes or sounds indicating their status. You can customize the sounds or triggers by editing the .bashrc file.

For more customization tips, see the comments in the .bashrc file.

Outputs a fantastic fanfair song using OS specific beep API when things complete. As well as a heartbeat sound every 20 seconds.

jgl sleep 30

(back to top)

Roadmap

1️⃣ Progress Sparkle / Interval Chimes

For really long-running commands (>1 min), play a subtle “sparkle” or coin sound every 30 seconds to show progress.

Example: [console]::beep(1500,40); [console]::beep(1600,40)

Gives a feeling like “you’re collecting coins while working.”

2️⃣ Command-specific melodies

Different tasks get unique chimes:

npm run build → classic Mario chime

npm test → short high-pitched “ding”

git pull → soft 2-note ascending tone

Makes it easy to know what finished without looking at the terminal.

3️⃣ Combo bonus for multiple successes

If multiple commands finish in sequence quickly, you could trigger a special “combo” melody, like stacking 3–4 Mario coins rapidly.

Encourages a playful sense of accomplishment when running batches.

4️⃣ Victory fanfare for consecutive successes

Keep a success streak counter in your Bash session.

After 3–5 consecutive successful commands, play a slightly longer or more elaborate “victory fanfare.”

5️⃣ Mini “fail feedback” melody variations

Make different failure tunes to indicate:

Minor failure → soft “oops”

Critical failure → longer descending sad tone

Can be mapped to exit codes if some commands return different error numbers.

6️⃣ Optional ambient chime for long-running processes

While a command is running >1 min, a subtle repeating sparkle or short 1–2 note pattern every 15–30 seconds keeps it interactive.

Gives you a “live progress soundscape” without needing visual monitoring.

7️⃣ Gamify with your terminal session

Track metrics like:

Total commands completed today

Longest successful streak

Play a special fanfare when hitting milestones (like “you completed 10 builds!”)

8️⃣ Custom user-defined melodies

Let the user define their own chime sequences in an array or config file.

Could include classic game sounds, short scales, or soft bells — anything [console]::beep can handle.

create a “full-featured gamified notifyme” version that:

Has progress chimes for long-running commands

Keeps success/failure variations

Plays stacked melodies / grand fanfare for long commands

Can even track streaks and milestones

Turn your terminal into a mini Mario reward system.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Your Name - @twitter_handle - email@email_client.com

Project Link: https://github.com/github_username/repo_name

(back to top)

Acknowledgments

(back to top)

☕💛☕🤝Buy Me A Coffee

If you found some value here, please consider fueling new features or the next project! Feel free to leave me a note and some coffee dollars go a long way!

• ☕💛☕🤝 Buy Me A Coffee