claude-sounds

Sound feedback for Claude Code using hooks. Plays Warcraft-style voice lines when Claude starts, receives a prompt, and finishes a task.

Hook Events

Event	Sound	Description
SessionStart	ready	Greeting when Claude starts
UserPromptSubmit	work	Acknowledgment when you send a prompt
SubagentStart	work	Sound when a subagent is spawned
EnterPlanMode	work	Sound when plan mode is entered
ExitPlanMode	done	Sound when plan mode is exited
PermissionRequest	ask	Sound when Claude asks for permission
Stop	done	Notification when Claude finishes

Each event plays a random sound from enabled sources, mapped via source.json.

Available Sources

• peon — Warcraft Orc Peon
• peasant — Warcraft Human Peasant
• bastion — Dota 2 Bastion Announcer Pack
• ra2 — Command & Conquer: Red Alert 2

Install

curl -fsSL https://raw.githubusercontent.com/lodev09/claude-sounds/main/install.sh | bash

Or clone and install locally:

git clone https://github.com/lodev09/claude-sounds.git
cd claude-sounds
./install.sh

This adds hooks to ~/.claude/settings.json and installs the claude-sounds CLI.

Usage

claude-sounds                    Interactive source select
claude-sounds sounds [source]    List sources or show sounds for a source
claude-sounds enable <source|all>
claude-sounds disable <source|all>
claude-sounds play <event>       Play a sound (ready, work, done, ask)
claude-sounds volume [0-1]       Get or set volume
claude-sounds status             Show install info
claude-sounds update             Pull latest from repo
claude-sounds uninstall

Customization

Create a new folder under sounds/ with a source.json mapping events to audio files:

sounds/my-source/
├── source.json
├── hello.mp3
└── done.wav

{
  "ready": ["hello.mp3"],
  "work": ["hello.mp3"],
  "done": ["done.wav"],
  "ask": ["hello.mp3"]
}

Then re-run ./install.sh.

Requirements

• macOS (afplay)
• python3 (for settings.json merging)

Credits

All audio assets are property of their respective owners and included here for personal, non-commercial use.

• Warcraft by Blizzard Entertainment
• Dota 2 Bastion Announcer Pack by Supergiant Games
• Command & Conquer: Red Alert 2 by Westwood Studios / EA

License

MIT