claude-code-sounds 1.1.0 → 1.2.0

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 7 themes. Bring your own sounds or create new ones.
 
 *"Something need doing?"*
 
@@ -53,154 +53,19 @@ npx claude-code-sounds --uninstall  # Remove all sounds and hooks
 npx claude-code-sounds --help       # Show help
 ```
 
-## WC3 Orc Peon Theme
+## Themes
 
-55 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`
-
-<details open>
-<summary><b>start</b> — Session starting, being summoned (5 sounds)</summary>
-
-| Sound | Quote | Unit |
+| Theme | Sounds | Vibe |
 |---|---|---|
-| `ready-to-work.wav` | *"Ready to work!"* | Peon |
-| `something-need-doing.wav` | *"Something need doing?"* | Peon |
-| `more-work.mp3` | *"More work?"* | Peon (WC2) |
-| `how-can-i-help.wav` | *"How can I help?"* | Shaman |
-| `someone-call-for-the-doctor.wav` | *"Someone call for the doctor?"* | Witch Doctor |
+| **WC3 Orc Peon** (`wc3-peon`) | 57 | *"Something need doing?"* — Peons, Grunts, Shamans, and Grom Hellscream |
+| **Zelda: Ocarina of Time** (`zelda-oot`) | 47 | *"Hey! Listen!"* — Navi, Link, and iconic OOT jingles |
+| **Super Mario Bros** (`mario`) | 47 | *"Let's-a go!"* — Coins, power-ups, and Mario's voice from NES to N64 |
+| **Star Wars** (`star-wars`) | 36 | *"May the Force be with you"* — Lightsabers, R2-D2, and the dark side |
+| **Metal Gear Solid** (`mgs`) | 40 | *"Kept you waiting, huh?"* — Codec calls, alert sounds, and Snake |
+| **Pokemon Gen 1** (`pokemon-gen1`) | 49 | *"Wild PIKACHU appeared!"* — Cries, battle sounds, and Kanto menus |
+| **Portal** (`portal`) | 42 | *"Are you still there?"* — Turrets, portal guns, and Aperture Science |
 
-</details>
-
-<details>
-<summary><b>prompt</b> — User submitted a prompt, acknowledging order (7 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `yes.wav` | *"Yes"* | Peon |
-| `dabu.wav` | *"Dabu"* | Grunt |
-| `zug-zug.wav` | *"Zug zug"* | Grunt |
-| `right-away.wav` | *"Right away"* | Shaman |
-| `immediately.wav` | *"Immediately!"* | Tauren |
-| `anything-you-want.wav` | *"Anything you want"* | Headhunter |
-| `more-work.mp3` | *"More work?"* | Peon (WC2) |
-
-</details>
-
-<details>
-<summary><b>stop</b> — Claude finished responding (8 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `zug-zug.wav` | *"Zug zug"* | Peon |
-| `ok.wav` | *"OK"* | Peon |
-| `i-can-do-that.wav` | *"I can do that"* | Peon |
-| `be-happy-to.wav` | *"Be happy to"* | Peon |
-| `understood.wav` | *"Understood"* | Shaman |
-| `of-course.wav` | *"Of course"* | Far Seer |
-| `it-is-certain.wav` | *"It is certain"* | Far Seer |
-| `whatever-you-say.wav` | *"Whatever you say"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>permission</b> — Permission prompt, waiting for approval (5 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `hmmm.wav` | *"Hmmm?"* | Peon |
-| `what-you-want.wav` | *"What you want?"* | Peon |
-| `what-you-want-me-to-do.wav` | *"What you want me to do?"* | Headhunter |
-| `who-you-want-me-kill.wav` | *"Who you want me kill?"* | Headhunter |
-| `you-seek-me-help.wav` | *"You seek me help?"* | Witch Doctor |
-
-</details>
-
-<details>
-<summary><b>subagent</b> — Spawning a subagent (6 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `work-work.wav` | *"Work, work"* | Peon |
-| `zug-zug.wav` | *"Zug zug"* | Peon |
-| `ill-try.wav` | *"I'll try"* | Peon |
-| `why-not.wav` | *"Why not?"* | Peon |
-| `for-the-horde.wav` | *"For the Horde!"* | Grunt |
-| `taste-the-fury.wav` | *"Taste the fury of the Warsong!"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>idle</b> — Waiting for user input (7 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
-| `no-time-for-play.wav` | *"No time for play!"* | Peon |
-| `me-not-that-kind-of-orc.wav` | *"Me not that kind of orc!"* | Peon |
-| `why-you-poking-me.wav` | *"Why are you poking me again?"* | Grunt |
-| `not-easy-being-green.wav` | *"It's not easy being green"* | Grunt |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-| `outlook-not-so-good.wav` | *"Outlook... not so good"* | Far Seer |
-
-</details>
-
-<details>
-<summary><b>error</b> — Tool call failed (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `peon-death.wav` | *(death sound)* | Peon |
-| `grunt-death.wav` | *(death sound)* | Grunt |
-| `headhunter-death.wav` | *(death sound)* | Headhunter |
-| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
-
-</details>
-
-<details>
-<summary><b>end</b> — Session ending (3 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `well-done.wav` | *"Well done!"* | Tauren |
-| `finally.wav` | *"Finally!"* | Grom Hellscream |
-| `okie-dokie.wav` | *"Okie dokie"* | Peon |
-
-</details>
-
-<details>
-<summary><b>task-completed</b> — Task marked done (2 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `well-done.wav` | *"Well done!"* | Tauren |
-| `finally.wav` | *"Finally!"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>compact</b> — Context compaction, memory fading (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `concentrate-and-ask-again.wav` | *"Concentrate... and ask again"* | Far Seer |
-| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-| `death.wav` | *(death sound)* | Peon |
-
-</details>
-
-<details>
-<summary><b>teammate-idle</b> — Teammate went idle (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `what.wav` | *"What?!"* | Peon |
-| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
-| `no-time-for-play.wav` | *"No time for play!"* | Peon |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-
-</details>
+Each theme maps sounds across all 11 Claude Code lifecycle events. Preview installed sounds with `./preview.sh`.
 
 ## Hook Events
 
@@ -230,6 +95,7 @@ Defines metadata and maps source files to hook categories:
 {
   "name": "My Theme",
   "description": "A short description",
+  "srcBase": "MyTheme",
   "sounds": {
     "start": {
       "description": "Session starting",
@@ -241,13 +107,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
 
@@ -279,4 +148,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. All game audio is property of its respective owners: Blizzard Entertainment (Warcraft), Nintendo (Zelda, Mario, Pokemon), Lucasfilm/Disney (Star Wars), Konami (Metal Gear Solid), and Valve (Portal).