Log in

Claude Code sound effects

Stop staring at the terminal. Make Claude Code play a vine boom when it's done, a Discord ping when it needs you and a sad violin when the tests fail. One hook, any of 38,000 meme sounds, free.

1. Add the hooks

Paste into ~/.claude/settings.json (merge with any hooks you already have). Stop fires when Claude finishes a response; Notification fires when it is waiting for you.

{ "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"vine boom\"" }] }], "Notification": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"discord notification\"" }] }], "SessionStart": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"windows xp startup\"" }] }] } }

Requires Node.js 20+. The first play downloads the MP3, after that it plays from cache. The command always exits 0, so it can never break a hook.

2. Pick your sounds

Tap to preview. Put the words under a sound into the hook command; it plays the best match.

Claude finished

Needs your input

Tests passed

Something broke

Session start

Want something else? Browse all sounds and use any title as the query.

3. Let Claude pick sounds itself (optional)

Install the plugin and Claude can search the whole catalog, find a sound for any moment and play it on request: "play a sound when the build passes", "find me a sound for an awkward silence".

/plugin marketplace add HalberdLLC/dank-meme-sounds /plugin install dank-meme-sounds@dankmachine

Codex CLI and your own scripts

Codex runs a notify command after each turn (it appends a JSON payload, which the CLI ignores). In ~/.codex/config.toml:

notify = ["npx", "-y", "dank-meme-sounds", "play", "vine boom"]

Anywhere else in your terminal:

npm test && npx -y dank-meme-sounds play "victory screech" || npx -y dank-meme-sounds play "mission failed"

FAQ

How do I make Claude Code play a sound when it finishes?

Add a Stop hook to ~/.claude/settings.json that runs npx -y dank-meme-sounds play "vine boom". Claude Code runs it every time it finishes a response.

Can Claude Code notify me when it needs permission or input?

Yes. The Notification hook fires when Claude Code waits for you. Point it at a different sound, like "discord notification", so you can tell the two apart.

Does it work on Windows, macOS and Linux?

Yes. The player uses afplay on macOS, Windows Media Player through PowerShell on Windows, and mpg123, ffplay or paplay on Linux. Node.js 20 or newer is required.

Will a missing sound or no internet break my hook?

No. The command caches sounds after the first play and always exits with code 0, so a hook never fails because of it.

Does it cost anything or need an API key?

No. The npm package, the MCP server and the API are free and need no key or account.

Made your terminal funnier?

The code is open source. A star helps other developers find it.

★ Star dank-meme-sounds on GitHub

More for developers: MCP server and API