claude-code-sound-packs

Claude Code Sound Packs

Add sound effects to your Claude Code sessions using hooks. Every action triggers a themed voice line.

Inspired by Delba's post showing Warcraft Peon sounds for Claude Code.

Quick Start
Sound files (WAV) are included in the repo so you don't need to download anything. The install.sh script re-downloads from source and converts, but you can also just copy the packs//sounds/ directory to ~/.claude/hooks/sounds// manually.

Available Packs

Hook Events

Each pack maps sounds to 8 Claude Code hook events:

Commands

./install.sh

Downloads sound files and converts them to WAV format. Installs to ~/.claude/hooks/sounds//.

Requirements: jq, ffmpeg, curl

./preview.sh

Play all sounds in a pack to hear them before activating.

./activate.sh

Merges sound hooks into ~/.claude/settings.json. Automatically deactivates any previously active pack.

- Preserves all non-sound hooks (e.g., PermissionRequest)
- Preserves all other settings (statusLine, plugins, MCP servers, etc.)
- Frequent events use async: true so sounds don't block Claude

./deactivate.sh

Removes sound hooks from ~/.claude/settings.json. Only removes events managed by the active pack.

Dependencies

Note: Currently macOS only due to afplay. PRs welcome for Linux (aplay/paplay) support!

How It Works

Claude Code hooks let you run shell commands on specific events. This project:

1. Downloads sound clips from public sources (wowhead CDN, myinstants, etc.)
2. Converts them to WAV format via ffmpeg
3. Creates hook entries in ~/.claude/settings.json that play sounds via afplay
4. Tracks which events are managed via a manifest file so deactivation is clean

Your settings.json hooks will look like:

Creating Your Own Pack

1. Create a new directory under packs/:

2. Define pack.json:

3.…