Git Audio

Add a spark of joy to coding: hear a surprise sound every time you commit. By default, it’s a sitcom laugh track.

For the Love of Code 2025 hackathon entry.

Features

• Cross-platform:
  • macOS (afplay)
  • Linux (aplay, paplay, ffplay)
• Quick setup with a single command!
• Ease of use thanks to simple CLI

Installation

Make sure you have Make installed, then run:

make install

That’s it! You can now use the git-audio command.

Usage

Per-repository

1. Install the hook into a repository

   git-audio repo:commit

2. Commit!

Global

1. Run

   git-audio global:commit

2. git init or git clone as usual
3. Commit!

Configuration

Configuration files are stored in $HOME/.git-audio/

$HOME/.git-audio/
  ├─ audio.wav
  ├─ cli.sh
  ├─ config.sh
  └─ templates
      └─ hooks
          └─ post-commit

To change the audio, run:

git-audio audio:set /path/to/your/audio

Documentation

See the documentation for complete instructions.

Thanks

• GitHub Copilot for co-piloting
• 🔈 Freesound for the audio
• 📔 og.new for the cover image