Claude Code notification

claude-sounds

A small macOS menu bar app for controlling the volume of Claude Code hook sounds.

Install

From source
git clone https://github.com/mikedotcook/claude-sounds.git

From the README

Claude Sounds

A macOS menu bar app for managing sound packs in Claude Code. Plays custom audio cues for Claude Code events like session start, prompt submit, notifications, and more.
Want to contribute a community sound pack? See community/README.md for how to create and submit your own pack. Community packs automatically appear in the app's Sound Pack Browser for all users to download.

Features

- Menu bar controls - Mute/unmute, volume slider, quick pack switching
- Sound Pack Browser - Browse, download, install, and manage sound packs
- Event Editor - Drag-and-drop audio files onto individual events; preview sounds inline
- Create Custom Packs - Built-in wizard to scaffold a new sound pack with all event directories
- Publish Packs - Export any local pack as a ZIP or submit it to the community registry via GitHub PR
- Setup Wizard - Guided first-run setup that installs Claude Code hooks automatically
- Hook integration - Installs shell hooks that trigger sounds on Claude Code events
- Audio validation - Magic-byte verification, ZIP preflight, and post-extract sanitization at every entry point

Supported Events

Audio Formats

Supports .wav, .mp3, .aiff, .m4a, .ogg, and .aac files.

Installation

Build from source

Requires macOS and Xcode Command Line Tools (xcode-select --install).

Sound Pack Structure

Sound packs live in ~/.claude/sounds// with one subdirectory per event:

Drop audio files into any event directory. When multiple files exist for an event, one is played at random.

License

MIT
Read the full README on GitHub

Details

Language
Swift
License
MIT
Last updated
3 March 2026
Topics
macosmenu-bar-app

FAQ

What is claude-sounds?

A small macOS menu bar app for controlling the volume of Claude Code hook sounds. It is a notification for Claude Code, from mikedotcook/claude-sounds on GitHub.

How do I install claude-sounds?

Clone mikedotcook/claude-sounds from GitHub and follow the setup steps in its README.

Is claude-sounds popular?

mikedotcook/claude-sounds has 15 GitHub stars and 2 forks. It was last updated on 3 March 2026.

More notifications & sounds

Browse the most popular Claude Code mods, all notifications & sounds, or the skills and MCP server directories.