Awesome Claude Code Sounds

Awesome Claude Code Sounds

A community-driven collection of sound packs for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) hooks. Turn your coding sessions into an immersive audio experience.

What is this?

Claude Code supports [lifecycle hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) that run shell commands at key moments: session start, prompt submit, task completion, and more. This repo provides **themed sound packs** that play audio clips on these events, plus a **universal installer** that handles cross-platform playback and safe `settings.json` merging.

Available Packs

Pack	Description	Sounds	Hooks	Author
aoe2-turkish-villager	Turkish villager voice lines from Age of Empires II	6	6	@mehmetsemihbabacan

Want to add yours? See [CONTRIBUTING.md](CONTRIBUTING.md).

Quick Install

git clone https://github.com/user/awesome-claude-code-sounds.git
cd awesome-claude-code-sounds
./install.sh aoe2-turkish-villager

Restart Claude Code to activate.

Quick Uninstall

./uninstall.sh aoe2-turkish-villager

List Packs

./list.sh

How It Works

1. Sound files are copied to ~/.claude/hooks/sounds// (namespaced per pack, no collisions)
2. Hook entries are merged into ~/.claude/settings.json without touching your existing config
3. Each hook randomly picks between assigned sounds so it doesn't get repetitive
4. Sounds play in the background (&) so they never block Claude Code

Platform Support

Platform	Audio Player	Status
macOS	afplay	Fully supported
Linux	paplay / aplay / mpg123	Fully supported
WSL	paplay via PulseAudio	Experimental

The installer auto-detects your platform and available audio player.

Create Your Own Pack

# 1. Cop