claude-code-sounds 1.0.0 → 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ryparker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,7 +8,7 @@
 
 Plays sound effects when sessions start, prompts are submitted, responses finish, errors occur, and more.
 
-Ships with a **WC3 Orc Peon** theme. Bring your own sounds or create new themes.
+Ships with a **WC3 Orc Peon** theme and a **Zelda: Ocarina of Time** theme. Bring your own sounds or create new themes.
 
 *"Something need doing?"*
 
@@ -20,7 +20,15 @@ Ships with a **WC3 Orc Peon** theme. Bring your own sounds or create new themes.
 npx claude-code-sounds
 ```
 
-That's it. Requires macOS (uses `afplay`) and Node.js 16+.
+The interactive installer checks dependencies, lets you pick a theme, and optionally customize which sounds map to each hook — all in the terminal.
+
+Requires macOS (uses `afplay`) and Node.js 16+.
+
+For scripted or CI usage, skip all prompts with `--yes`:
+
+```bash
+npx claude-code-sounds --yes
+```
 
 <details>
 <summary>Alternative: install from source</summary>
@@ -38,15 +46,16 @@ The bash installer requires `jq` (`brew install jq`).
 ## Usage
 
 ```bash
-npx claude-code-sounds              # Install default theme (wc3-peon)
-npx claude-code-sounds <theme>      # Install a specific theme
+npx claude-code-sounds              # Interactive install
+npx claude-code-sounds --yes        # Install defaults, skip all prompts
 npx claude-code-sounds --list       # List available themes
 npx claude-code-sounds --uninstall  # Remove all sounds and hooks
+npx claude-code-sounds --help       # Show help
 ```
 
 ## WC3 Orc Peon Theme
 
-55 sounds from Warcraft 3 Orc units mapped across 11 Claude Code lifecycle events.
+57 sounds from Warcraft 3 Orc units mapped across 11 Claude Code lifecycle events.
 
 > After installing, preview all sounds with `./preview.sh` or a specific category with `./preview.sh start`
 
@@ -79,11 +88,12 @@ npx claude-code-sounds --uninstall  # Remove all sounds and hooks
 </details>
 
 <details>
-<summary><b>stop</b> — Claude finished responding (8 sounds)</summary>
+<summary><b>stop</b> — Claude finished responding (9 sounds)</summary>
 
 | Sound | Quote | Unit |
 |---|---|---|
-| `zug-zug.wav` | *"Zug zug"* | Peon |
+| `zug-zug.wav` | *"Zug zug"* | Grunt |
+| `get-em.wav` | *"Get 'em!"* | Peon |
 | `ok.wav` | *"OK"* | Peon |
 | `i-can-do-that.wav` | *"I can do that"* | Peon |
 | `be-happy-to.wav` | *"Be happy to"* | Peon |
@@ -108,12 +118,13 @@ npx claude-code-sounds --uninstall  # Remove all sounds and hooks
 </details>
 
 <details>
-<summary><b>subagent</b> — Spawning a subagent (6 sounds)</summary>
+<summary><b>subagent</b> — Spawning a subagent (7 sounds)</summary>
 
 | Sound | Quote | Unit |
 |---|---|---|
 | `work-work.wav` | *"Work, work"* | Peon |
-| `zug-zug.wav` | *"Zug zug"* | Peon |
+| `zug-zug.wav` | *"Zug zug"* | Grunt |
+| `get-em.wav` | *"Get 'em!"* | Peon |
 | `ill-try.wav` | *"I'll try"* | Peon |
 | `why-not.wav` | *"Why not?"* | Peon |
 | `for-the-horde.wav` | *"For the Horde!"* | Grunt |
@@ -193,6 +204,147 @@ npx claude-code-sounds --uninstall  # Remove all sounds and hooks
 
 </details>
 
+## Zelda: Ocarina of Time Theme
+
+47 sounds from Navi, Link, Ganondorf, and iconic OOT jingles mapped across 11 Claude Code lifecycle events.
+
+*"Hey! Listen!"*
+
+<details open>
+<summary><b>start</b> — Session starting, Navi greets you (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `hey.wav` | *"Hey!"* | Navi |
+| `hello.wav` | *"Hello!"* | Navi |
+| `listen.wav` | *"Listen!"* | Navi |
+| `great-fairy-laugh.wav` | *(magical laugh)* | Great Fairy |
+| `open-chest.wav` | *(opening big chest)* | SFX |
+
+</details>
+
+<details>
+<summary><b>prompt</b> — User submitted a prompt, adventure continues (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `hey.wav` | *"Hey!"* | Navi |
+| `look.wav` | *"Look!"* | Navi |
+| `menu-select.wav` | *(menu select)* | SFX |
+| `dialogue-next.wav` | *(continue dialogue)* | SFX |
+| `get-heart.wav` | *(get heart)* | SFX |
+
+</details>
+
+<details>
+<summary><b>stop</b> — Claude finished responding (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `secret-discovered.wav` | *(secret jingle)* | SFX |
+| `get-item.wav` | *(get small item)* | SFX |
+| `get-rupee.wav` | *(get rupee)* | SFX |
+| `open-small-chest.wav` | *(open small chest)* | SFX |
+| `song-correct.wav` | *(song played correctly)* | SFX |
+
+</details>
+
+<details>
+<summary><b>permission</b> — Permission prompt, waiting for approval (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `watch-out.wav` | *"Watch out!"* | Navi |
+| `hey.wav` | *"Hey!"* | Navi |
+| `listen.wav` | *"Listen!"* | Navi |
+| `pause-menu.wav` | *(pause menu open)* | SFX |
+| `z-target.wav` | *(Z-target enemy)* | SFX |
+
+</details>
+
+<details>
+<summary><b>subagent</b> — Spawning a subagent (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `sword-draw.wav` | *(draw sword)* | SFX |
+| `link-attack.wav` | *(attack shout)* | Adult Link |
+| `link-strong-attack.wav` | *(strong attack)* | Adult Link |
+| `hey.wav` | *"Hey!"* | Navi |
+| `spin-attack.wav` | *(spin attack)* | SFX |
+
+</details>
+
+<details>
+<summary><b>idle</b> — Waiting for user input (5 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `hey.wav` | *"Hey!"* | Navi |
+| `listen.wav` | *"Listen!"* | Navi |
+| `watch-out.wav` | *"Watch out!"* | Navi |
+| `low-health.wav` | *(low health beep)* | SFX |
+| `snore.wav` | *(Talon snoring)* | Talon |
+
+</details>
+
+<details>
+<summary><b>error</b> — Tool call failed (4 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `error.wav` | *(error sound)* | SFX |
+| `song-error.wav` | *(wrong note)* | SFX |
+| `link-hurt.wav` | *(Link hurt)* | Adult Link |
+| `ganondorf-laugh.wav` | *(Ganondorf laughing)* | Ganondorf |
+
+</details>
+
+<details>
+<summary><b>end</b> — Session ending (3 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `item-fanfare.wav` | *(item fanfare)* | SFX |
+| `secret-discovered.wav` | *(secret jingle)* | SFX |
+| `dialogue-done.wav` | *(dialogue finished)* | SFX |
+
+</details>
+
+<details>
+<summary><b>task-completed</b> — Task marked done (2 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `item-fanfare.wav` | *(item fanfare)* | SFX |
+| `secret-discovered.wav` | *(secret jingle)* | SFX |
+
+</details>
+
+<details>
+<summary><b>compact</b> — Context compaction, health running low (4 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `low-health.wav` | *(low health beep)* | SFX |
+| `pause-close.wav` | *(pause menu close)* | SFX |
+| `watch-out.wav` | *"Watch out!"* | Navi |
+| `error.wav` | *(error sound)* | SFX |
+
+</details>
+
+<details>
+<summary><b>teammate-idle</b> — Teammate went idle (4 sounds)</summary>
+
+| Sound | Description | Source |
+|---|---|---|
+| `hey.wav` | *"Hey!"* | Navi |
+| `listen.wav` | *"Listen!"* | Navi |
+| `watch-out.wav` | *"Watch out!"* | Navi |
+| `low-health.wav` | *(low health beep)* | SFX |
+
+</details>
+
 ## Hook Events
 
 | Event | Hook | When |
@@ -221,6 +373,7 @@ Defines metadata and maps source files to hook categories:
 {
   "name": "My Theme",
   "description": "A short description",
+  "srcBase": "MyTheme",
   "sounds": {
     "start": {
       "description": "Session starting",
@@ -232,13 +385,16 @@ Defines metadata and maps source files to hook categories:
 }
 ```
 
+- **`srcBase`** — subdirectory under the temp dir where downloaded files live (e.g., `"Orc"`, `"OOT"`)
+- **`src`** — path relative to `$2/<srcBase>/` where the file is found after download
+
 ### `download.sh`
 
 Downloads the sound files. Receives two arguments:
 - `$1` — target sounds directory (`~/.claude/sounds`)
 - `$2` — temp directory for downloads
 
-The script should download and extract files so they're accessible at `$2/Orc/<src path>` (matching the `src` values in `theme.json`).
+The script should download and extract files so they're accessible at `$2/<srcBase>/<src path>` (matching the `srcBase` and `src` values in `theme.json`).
 
 ## How It Works
 
@@ -270,4 +426,4 @@ This removes all sound files, the hook script, and the hooks config from `settin
 
 ## Disclaimer
 
-Sound files are downloaded from third-party sources at install time and are not included in this repository. All game audio is property of Blizzard Entertainment.
+Sound files are downloaded from third-party sources at install time and are not included in this repository. Warcraft audio is property of Blizzard Entertainment. Zelda audio is property of Nintendo.