SoundBooth

A browser-based studio for previewing, comparing, and mapping royalty-free UI sounds to interface interactions. Built for designers and developers who want to add audio feedback to their products without the guesswork.

Two tools, zero dependencies, runs from a local file.

---

What's Inside

Tool	File	Purpose
Soundboard	sound-board.html	Browse and preview all 242 sounds across 7 kits
Mapper	sound-mapper.html	Map specific sounds to 39 UI interaction events, then export as JSON

Sound Kits (242 sounds)

Kit	Sounds	License	Style
Kenney	67	CC0	Clicks, toggles, switches, glass, plucks
Octave	35	Free	Beeps, taps, slides
Notifications	25	Open	Chimes and alerts
SND Sine	28	Free	Soft, synthetic taps and transitions
SND Piano	27	Free	Warm, piano-based UI sounds
SND Industrial	27	Free	Mechanical, tactile feedback
Minimal UI	24	CC-BY-SA	System sounds, dialogs, device events

---

Getting Started

No build step. No install. Just open in a browser.

# Clone the repo
git clone https://github.com/your-org/soundbooth.git
cd soundbooth

# Open either tool
open sound-board.html
open sound-mapper.html

Or serve locally if you prefer (avoids file:// quirks in some browsers):

npx serve .
# then visit http://localhost:3000/sound-board.html

---

Soundboard

The Soundboard lets you browse, search, and preview every sound in the collection.

• Filter by kit — tabs at the top filter to a single source
• Search — type to filter sounds by name or category
• Volume control — master volume slider in the top-right corner
• Keyboard shortcuts:
  • Space — replay the last sound
  • Left / Right arrow — step through sounds

Each tile shows the sound name, category, and a waveform visualization. Click any tile to play.

---

Mapper

The Mapper assigns sounds to specific UI interaction events (message sent, tool success, permission prompt, etc.) and exports the result as a JSON config.

Workflow

• Switch to the Sound Mapper tab at the top of the page
• Browse rows — each row is a UI event (grouped by category: Message Lifecycle, Tool Execution, Permissions, etc.)
• Pick a sound from the dropdown on each row, or click the play button to preview the current selection
• Adjust playback — use the sidebar controls for volume, speed, loop, and overlap
• Export — click Export JSON to download your mapping as sound-map.json
• Import — click Import JSON to paste a previously exported mapping and restore it

Soundboard Tab

The Mapper also includes a built-in Soundboard tab for browsing sounds by kit without leaving the tool. Click any sound tile to hear it and see the waveform in the sidebar.

Export Format

The exported JSON maps interaction IDs to sound metadata:

{
  "msg-sent": {
    "kit": "snd-sine",
    "sound": "transition_up",
    "path": "sounds/snd-sine/transition_up.wav"
  },
  "stream-success": {
    "kit": "snd-sine",
    "sound": "celebration",
    "path": "sounds/snd-sine/celebration.wav"
  }
}

Use this JSON in your application to load the correct sound files for each interaction.

---

Interaction Events

The Mapper covers 39 UI events across 8 categories:

Category	Events
Message Lifecycle	Message sent, streaming begins/complete, user stops, context compaction
Tool Execution	Tool start, success, failure, bash execution, file edit
Permissions	Prompt, grant, deny, cross-session risk
Navigation	Quick launch, conversation switcher, file panel, sidebar, tabs, view mode
Input & Composition	Slash commands, file mentions, uploads, suggestion chips
Notifications	Updates, errors, connection lost/restored
File & Editor	File open, lightbox, find-in-file, code copy, artifact expand
Destructive Actions	Confirm dialog, destructive confirm, feedback submit

---

Project Structure

soundbooth/
  sound-board.html      # Sound browser/preview tool
  sound-mapper.html     # Interaction-to-sound mapper
  sound-board.png       # Screenshot
  sound-mapper.png      # Screenshot
  sounds/
    kenney/             # 67 .wav files
    octave/             # 35 .wav files
    notifications/      # 25 .wav files
    snd-sine/           # 28 .wav files
    snd-piano/          # 27 .wav files
    snd-industrial/     # 27 .wav files
    minimal-ui/         # 24 .wav files

---

License

All sound assets are royalty-free under their respective licenses (CC0, CC-BY-SA, or Free). See individual kit documentation for details. The tool code itself is provided as-is for internal and public use.