sounds

claude-sounds

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

Install

claude plugin marketplace add lodev09/claude-plugins
claude plugin install sounds@lodev09

For CLI access, also install via npm:

npm install -g @lodev09/claude-sounds

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

Usage

Use /sounds inside Claude Code or claude-sounds from the terminal (requires npm install).

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 on                       # Turn sounds on
claude-sounds off                      # Turn sounds off
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

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"]
}

Requirements

• python3
• Audio player (auto-detected):
  • macOS — afplay (built-in)
  • Linux — pw-play, paplay, or ffplay
  • Windows — ffplay or PowerShell (built-in)

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