claude-code-sounds 1.1.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?"*
 
@@ -55,7 +55,7 @@ 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`
 
@@ -88,11 +88,12 @@ npx claude-code-sounds --help       # Show help
 </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 |
@@ -117,12 +118,13 @@ npx claude-code-sounds --help       # Show help
 </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 |
@@ -202,6 +204,147 @@ npx claude-code-sounds --help       # Show help
 
 </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 |
@@ -230,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",
@@ -241,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
 
@@ -279,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.

package/bin/cli.js

@@ -14,6 +14,7 @@ const SOUNDS_DIR = path.join(CLAUDE_DIR, "sounds");
 const HOOKS_DIR = path.join(CLAUDE_DIR, "hooks");
 const SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
 const THEMES_DIR = path.join(PKG_DIR, "themes");
+const INSTALLED_PATH = path.join(SOUNDS_DIR, ".installed.json");
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -66,6 +67,53 @@ function hasCommand(name) {
   }
 }
 
+function readInstalled() {
+  if (fs.existsSync(INSTALLED_PATH)) {
+    return JSON.parse(fs.readFileSync(INSTALLED_PATH, "utf-8"));
+  }
+  return null;
+}
+
+function writeInstalled(themeName) {
+  mkdirp(SOUNDS_DIR);
+  fs.writeFileSync(INSTALLED_PATH, JSON.stringify({ theme: themeName }, null, 2) + "\n");
+}
+
+/**
+ * Check if sounds are already installed.
+ * Returns { theme, themeDisplay, totalEnabled, totalAvailable, categories } or null.
+ */
+function getExistingInstall() {
+  const installed = readInstalled();
+  if (!installed) return null;
+
+  const themeJsonPath = path.join(THEMES_DIR, installed.theme, "theme.json");
+  if (!fs.existsSync(themeJsonPath)) return null;
+
+  const theme = JSON.parse(fs.readFileSync(themeJsonPath, "utf-8"));
+  let totalEnabled = 0;
+  const totalAvailable = Object.values(theme.sounds).reduce((sum, c) => sum + c.files.length, 0);
+
+  for (const cat of Object.keys(theme.sounds)) {
+    const catDir = path.join(SOUNDS_DIR, cat);
+    try {
+      for (const f of fs.readdirSync(catDir)) {
+        if (f.endsWith(".wav") || f.endsWith(".mp3")) totalEnabled++;
+      }
+    } catch {}
+  }
+
+  if (totalEnabled === 0) return null;
+
+  return {
+    theme: installed.theme,
+    themeDisplay: theme.name,
+    themeDescription: theme.description,
+    totalEnabled,
+    totalAvailable,
+  };
+}
+
 // ─── ANSI helpers ────────────────────────────────────────────────────────────
 
 const CSI = "\x1b[";
@@ -191,29 +239,61 @@ function select(title, options) {
 
 /**
  * Multi-select checklist with toggle, preview, and confirm.
- * Returns array of selected indices.
+ * Returns array of selected indices, or null if back was pressed.
  */
-function multiSelect(title, items, defaults, previewDir) {
+function multiSelect(title, items, defaults, previewDir, { allowBack = false } = {}) {
   return new Promise((resolve) => {
     let cursor = 0;
+    let scrollTop = 0;
     const checked = items.map((_, i) => defaults.includes(i));
-    const lineCount = items.length + 3; // title + blank + items + hint
+
+    // Calculate scrolling dimensions
+    const termRows = process.stdout.rows || 24;
+    const maxItemRows = Math.max(5, termRows - 5); // 5 = title + blank + hint + 2 buffer
+    const needsScroll = items.length > maxItemRows;
+    // When scrolling, reserve 2 rows for ▲/▼ indicators (always present for stable line count)
+    const visibleCount = needsScroll ? maxItemRows - 2 : items.length;
+    const lineCount = needsScroll ? maxItemRows + 3 : items.length + 3;
+
+    function adjustScroll() {
+      if (!needsScroll) return;
+      if (cursor < scrollTop) scrollTop = cursor;
+      if (cursor >= scrollTop + visibleCount) scrollTop = cursor - visibleCount + 1;
+    }
 
     function render(initial) {
       if (!initial) moveCursorUp(lineCount);
       print(`  ${title}\n`);
-      for (let i = 0; i < items.length; i++) {
-        const pointer = i === cursor ? `${CYAN}  ❯ ` : "    ";
-        const box = checked[i] ? `${GREEN}[✓]${RESET}` : `${DIM}[ ]${RESET}`;
-        const label = items[i].label;
-        const desc = items[i].description ? `  ${DIM}${items[i].description}${RESET}` : "";
-        print(`${pointer}${RESET}${box} ${label}${desc}`);
+
+      if (needsScroll) {
+        const above = scrollTop;
+        const below = items.length - scrollTop - visibleCount;
+        print(above > 0 ? `${DIM}    ▲ ${above} more${RESET}` : "");
+        for (let i = scrollTop; i < scrollTop + visibleCount; i++) {
+          const pointer = i === cursor ? `${CYAN}  ❯ ` : "    ";
+          const box = checked[i] ? `${GREEN}[✓]${RESET}` : `${DIM}[ ]${RESET}`;
+          const label = items[i].label;
+          const desc = items[i].description ? `  ${DIM}${items[i].description}${RESET}` : "";
+          print(`${pointer}${RESET}${box} ${label}${desc}`);
+        }
+        print(below > 0 ? `${DIM}    ▼ ${below} more${RESET}` : "");
+      } else {
+        for (let i = 0; i < items.length; i++) {
+          const pointer = i === cursor ? `${CYAN}  ❯ ` : "    ";
+          const box = checked[i] ? `${GREEN}[✓]${RESET}` : `${DIM}[ ]${RESET}`;
+          const label = items[i].label;
+          const desc = items[i].description ? `  ${DIM}${items[i].description}${RESET}` : "";
+          print(`${pointer}${RESET}${box} ${label}${desc}`);
+        }
       }
+
       const previewHint = previewDir ? " · p preview" : "";
-      print(`${DIM}  ↑↓ navigate · space toggle${previewHint} · enter confirm${RESET}`);
+      const backHint = allowBack ? "← back · " : "";
+      print(`${DIM}  ${backHint}↑↓ navigate · space toggle · a all${previewHint} · →/enter confirm${RESET}`);
     }
 
     process.stdout.write(HIDE_CURSOR);
+    adjustScroll();
     render(true);
 
     process.stdin.setRawMode(true);
@@ -230,14 +310,29 @@ function multiSelect(title, items, defaults, previewDir) {
         return;
       }
 
+      // Left arrow — go back
+      if (allowBack && key === "\x1b[D") {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeListener("data", onKey);
+        killPreview();
+        moveCursorUp(lineCount);
+        clearLines(lineCount);
+        process.stdout.write(SHOW_CURSOR);
+        resolve(null);
+        return;
+      }
+
       if (key === "\x1b[A" || key === "k") {
         cursor = (cursor - 1 + items.length) % items.length;
+        adjustScroll();
         render(false);
         return;
       }
 
       if (key === "\x1b[B" || key === "j") {
         cursor = (cursor + 1) % items.length;
+        adjustScroll();
         render(false);
         return;
       }
@@ -249,6 +344,14 @@ function multiSelect(title, items, defaults, previewDir) {
         return;
       }
 
+      // a — toggle all
+      if (key === "a") {
+        const allChecked = checked.every(Boolean);
+        checked.fill(!allChecked);
+        render(false);
+        return;
+      }
+
       // p — preview sound
       if (key === "p" && previewDir && items[cursor].file) {
         const soundPath = path.join(previewDir, items[cursor].file);
@@ -256,8 +359,8 @@ function multiSelect(title, items, defaults, previewDir) {
         return;
       }
 
-      // Enter — confirm
-      if (key === "\r" || key === "\n") {
+      // Enter or right arrow — confirm
+      if (key === "\r" || key === "\n" || key === "\x1b[C") {
         process.stdin.setRawMode(false);
         process.stdin.pause();
         process.stdin.removeListener("data", onKey);
@@ -375,6 +478,183 @@ function uninstall() {
   print("");
 }
 
+// ─── Sound Item Builder ─────────────────────────────────────────────────────
+
+/**
+ * Build the full list of sound items for a category.
+ * Native sounds (from this category's theme.json entry) come first,
+ * then borrowed sounds from all other categories, deduplicated by filename.
+ */
+function buildCategoryItems(theme, category) {
+  const config = theme.sounds[category];
+  const categories = Object.keys(theme.sounds);
+  const items = [];
+  const seen = new Set();
+
+  // Build a map of filename -> list of hooks it appears in
+  const hookMap = {};
+  for (const cat of categories) {
+    for (const f of theme.sounds[cat].files) {
+      if (!hookMap[f.name]) hookMap[f.name] = [];
+      if (!hookMap[f.name].includes(cat)) hookMap[f.name].push(cat);
+    }
+  }
+
+  // Native sounds first
+  for (const f of config.files) {
+    seen.add(f.name);
+    items.push({
+      label: f.name.replace(/\.(wav|mp3)$/, ""),
+      description: hookMap[f.name].join(", "),
+      file: f.name,
+      src: f.src,
+      native: true,
+      originCat: category,
+    });
+  }
+
+  // Borrowed sounds from other categories
+  for (const otherCat of categories) {
+    if (otherCat === category) continue;
+    for (const f of theme.sounds[otherCat].files) {
+      if (seen.has(f.name)) continue;
+      seen.add(f.name);
+      items.push({
+        label: f.name.replace(/\.(wav|mp3)$/, ""),
+        description: hookMap[f.name].join(", "),
+        file: f.name,
+        src: f.src,
+        native: false,
+        originCat: otherCat,
+      });
+    }
+  }
+
+  return items;
+}
+
+/**
+ * Resolve a sound file's source from download (tmpDir/<srcBase>/...).
+ */
+function resolveDownloadSrc(srcBase, src) {
+  if (src.startsWith("@soundfxcenter/")) {
+    return path.join(srcBase, path.basename(src));
+  }
+  return path.join(srcBase, src);
+}
+
+// ─── Reconfigure Flow ───────────────────────────────────────────────────────
+
+async function reconfigure(existingInstall) {
+  const themeDir = path.join(THEMES_DIR, existingInstall.theme);
+  const theme = JSON.parse(fs.readFileSync(path.join(themeDir, "theme.json"), "utf-8"));
+  const categories = Object.keys(theme.sounds);
+  const tmpDirs = [];
+
+  try {
+    let catIdx = 0;
+    while (catIdx < categories.length) {
+      const cat = categories[catIdx];
+      const config = theme.sounds[cat];
+      const catDir = path.join(SOUNDS_DIR, cat);
+      const disabledDir = path.join(catDir, ".disabled");
+      const items = buildCategoryItems(theme, cat);
+
+      // Determine current state: checked if file exists in category dir
+      const defaults = [];
+      for (let i = 0; i < items.length; i++) {
+        if (fs.existsSync(path.join(catDir, items[i].file))) {
+          defaults.push(i);
+        }
+      }
+
+      // Build preview dir with all sounds from all possible locations
+      const previewDir = fs.mkdtempSync(path.join(os.tmpdir(), `claude-preview-`));
+      tmpDirs.push(previewDir);
+      for (const item of items) {
+        const originCatDir = path.join(SOUNDS_DIR, item.originCat);
+        const originDisabledDir = path.join(originCatDir, ".disabled");
+        const searchDirs = [catDir, disabledDir, originCatDir, originDisabledDir];
+        for (const dir of searchDirs) {
+          const p = path.join(dir, item.file);
+          if (fs.existsSync(p)) {
+            fs.copyFileSync(p, path.join(previewDir, item.file));
+            break;
+          }
+        }
+      }
+
+      const selected = await multiSelect(
+        `${BOLD}${cat}${RESET} ${DIM}— ${config.description}${RESET}`,
+        items,
+        defaults,
+        previewDir,
+        { allowBack: catIdx > 0 }
+      );
+
+      // Back was pressed — go to previous category
+      if (selected === null) {
+        catIdx--;
+        continue;
+      }
+
+      // Apply changes
+      for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const isSelected = selected.includes(i);
+        const enabledPath = path.join(catDir, item.file);
+
+        if (item.native) {
+          const disabledPath = path.join(disabledDir, item.file);
+          if (isSelected && !fs.existsSync(enabledPath) && fs.existsSync(disabledPath)) {
+            fs.renameSync(disabledPath, enabledPath);
+          } else if (!isSelected && fs.existsSync(enabledPath)) {
+            mkdirp(disabledDir);
+            fs.renameSync(enabledPath, disabledPath);
+          }
+        } else {
+          // Borrowed sound: copy in or delete
+          if (isSelected && !fs.existsSync(enabledPath)) {
+            const previewFile = path.join(previewDir, item.file);
+            if (fs.existsSync(previewFile)) {
+              fs.copyFileSync(previewFile, enabledPath);
+            }
+          } else if (!isSelected && fs.existsSync(enabledPath)) {
+            fs.unlinkSync(enabledPath);
+          }
+        }
+      }
+
+      catIdx++;
+    }
+  } finally {
+    for (const dir of tmpDirs) {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  }
+
+  // Summary
+  let total = 0;
+  print(`  ${GREEN}✓${RESET} Configuration updated!`);
+  print("  ─────────────────────────────────────");
+
+  for (const cat of categories) {
+    const catDir = path.join(SOUNDS_DIR, cat);
+    let count = 0;
+    try {
+      for (const f of fs.readdirSync(catDir)) {
+        if (f.endsWith(".wav") || f.endsWith(".mp3")) count++;
+      }
+    } catch {}
+    total += count;
+    print(`    ${cat} (${count}) — ${theme.sounds[cat].description}`);
+  }
+
+  print("");
+  print(`  ${total} sound files across ${categories.length} events.`);
+  print("");
+}
+
 // ─── Install Flow ───────────────────────────────────────────────────────────
 
 async function interactiveInstall(autoYes) {
@@ -383,6 +663,31 @@ async function interactiveInstall(autoYes) {
   print("  ──────────────────────────────");
   print("");
 
+  // ── Detect existing install ───────────────────────────────────────────────
+
+  const existingInstall = getExistingInstall();
+
+  if (existingInstall && !autoYes) {
+    print(`  ${GREEN}✓${RESET} Already installed — ${BOLD}${existingInstall.themeDisplay}${RESET}`);
+    print(`    ${existingInstall.totalEnabled}/${existingInstall.totalAvailable} sounds enabled\n`);
+
+    const actionIdx = await select("What would you like to do?", [
+      { label: "Reconfigure", description: "Choose which sounds are enabled" },
+      { label: "Reinstall", description: "Re-download and start fresh" },
+      { label: "Uninstall", description: "Remove all sounds and hooks" },
+    ]);
+
+    if (actionIdx === 0) {
+      await reconfigure(existingInstall);
+      return;
+    }
+    if (actionIdx === 2) {
+      uninstall();
+      return;
+    }
+    // actionIdx === 1 falls through to full install
+  }
+
   // ── Step 1: Dependency Check ──────────────────────────────────────────────
 
   const deps = ["afplay", "curl", "unzip"];
@@ -469,10 +774,14 @@ async function interactiveInstall(autoYes) {
 
     // ── Step 4: Customize or Accept Defaults ──────────────────────────────
 
-    // Build a selection map: category -> array of file indices to include
+    // Build items and selections for each category (includes all theme sounds)
+    const categoryItems = {};
     const selections = {};
     for (const cat of categories) {
-      selections[cat] = theme.sounds[cat].files.map((_, i) => i);
+      const items = buildCategoryItems(theme, cat);
+      categoryItems[cat] = items;
+      // Default: select only native sounds
+      selections[cat] = items.map((item, i) => item.native ? i : -1).filter(i => i >= 0);
     }
 
     if (!autoYes) {
@@ -483,29 +792,21 @@ async function interactiveInstall(autoYes) {
       const customizeIdx = await select("Customize sounds for each hook?", customizeOptions);
 
       if (customizeIdx === 1) {
-        // Customize each category
-        for (const cat of categories) {
+        const srcBase = path.join(tmpDir, theme.srcBase || "Orc");
+        let catIdx = 0;
+
+        while (catIdx < categories.length) {
+          const cat = categories[catIdx];
           const config = theme.sounds[cat];
-          const items = config.files.map((f) => ({
-            label: f.name.replace(/\.(wav|mp3)$/, ""),
-            description: f.description || "",
-            file: f.name,
-          }));
-          const defaults = config.files.map((_, i) => i); // all selected by default
-
-          // Build preview dir: sounds are in tmpDir/Orc/... but we need them by name
-          // Copy files to a temp preview dir first
+          const items = categoryItems[cat];
+          const defaults = selections[cat];
+
+          // Build preview dir with ALL theme sounds
           const previewDir = path.join(tmpDir, "_preview", cat);
           mkdirp(previewDir);
-          const srcBase = path.join(tmpDir, "Orc");
-          for (const file of config.files) {
-            let srcFile;
-            if (file.src.startsWith("@soundfxcenter/")) {
-              srcFile = path.join(srcBase, path.basename(file.src));
-            } else {
-              srcFile = path.join(srcBase, file.src);
-            }
-            const destFile = path.join(previewDir, file.name);
+          for (const item of items) {
+            const srcFile = resolveDownloadSrc(srcBase, item.src);
+            const destFile = path.join(previewDir, item.file);
             if (fs.existsSync(srcFile)) {
               fs.copyFileSync(srcFile, destFile);
             }
@@ -515,9 +816,17 @@ async function interactiveInstall(autoYes) {
             `${BOLD}${cat}${RESET} ${DIM}— ${config.description}${RESET}`,
             items,
             defaults,
-            previewDir
+            previewDir,
+            { allowBack: catIdx > 0 }
           );
+
+          if (selected === null) {
+            catIdx--;
+            continue;
+          }
+
           selections[cat] = selected;
+          catIdx++;
         }
       }
     }
@@ -526,40 +835,54 @@ async function interactiveInstall(autoYes) {
 
     print("  Installing sounds...");
 
-    // Clear existing sounds
+    // Clear existing sounds and .disabled dirs
     for (const cat of categories) {
       const catDir = path.join(SOUNDS_DIR, cat);
       for (const f of fs.readdirSync(catDir)) {
-        if (f.endsWith(".wav") || f.endsWith(".mp3")) {
-          fs.unlinkSync(path.join(catDir, f));
+        const fp = path.join(catDir, f);
+        if (f === ".disabled") {
+          fs.rmSync(fp, { recursive: true, force: true });
+        } else if (f.endsWith(".wav") || f.endsWith(".mp3")) {
+          fs.unlinkSync(fp);
         }
       }
     }
 
-    // Copy selected files
-    const srcBase = path.join(tmpDir, "Orc");
+    // Copy files from download based on selections
+    const srcBase = path.join(tmpDir, theme.srcBase || "Orc");
     let total = 0;
-    for (const [category, config] of Object.entries(theme.sounds)) {
-      const selectedIndices = selections[category];
-      for (const idx of selectedIndices) {
-        const file = config.files[idx];
-        let srcFile;
-        if (file.src.startsWith("@soundfxcenter/")) {
-          srcFile = path.join(srcBase, path.basename(file.src));
-        } else {
-          srcFile = path.join(srcBase, file.src);
+    for (const cat of categories) {
+      const items = categoryItems[cat];
+      const selectedIndices = selections[cat];
+      const catDir = path.join(SOUNDS_DIR, cat);
+      const disabledDir = path.join(catDir, ".disabled");
+
+      for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const srcFile = resolveDownloadSrc(srcBase, item.src);
+
+        if (!fs.existsSync(srcFile)) {
+          if (item.native) {
+            print(`    ${YELLOW}⚠${RESET} ${item.src} not found, skipping`);
+          }
+          continue;
         }
 
-        const destFile = path.join(SOUNDS_DIR, category, file.name);
-        if (fs.existsSync(srcFile)) {
-          fs.copyFileSync(srcFile, destFile);
+        if (selectedIndices.includes(i)) {
+          fs.copyFileSync(srcFile, path.join(catDir, item.file));
           total++;
-        } else {
-          print(`    ${YELLOW}⚠${RESET} ${file.src} not found, skipping`);
+        } else if (item.native) {
+          // Save unselected native sounds to .disabled for future reconfigure
+          mkdirp(disabledDir);
+          fs.copyFileSync(srcFile, path.join(disabledDir, item.file));
         }
+        // Unselected borrowed sounds: skip (no need to store)
       }
     }
 
+    // Write install marker
+    writeInstalled(selectedTheme.name);
+
     // Copy play-sound.sh hook
     const hookSrc = path.join(PKG_DIR, "hooks", "play-sound.sh");
     const hookDest = path.join(HOOKS_DIR, "play-sound.sh");
@@ -576,11 +899,9 @@ async function interactiveInstall(autoYes) {
     print(`  ${GREEN}✓${RESET} Installed! Here's what you'll hear:`);
     print("  ─────────────────────────────────────");
 
-    for (const [cat, config] of Object.entries(theme.sounds)) {
+    for (const cat of categories) {
       const count = selections[cat].length;
-      const totalAvailable = config.files.length;
-      const suffix = count < totalAvailable ? ` (${count}/${totalAvailable})` : ` (${count})`;
-      print(`    ${cat}${suffix} — ${config.description}`);
+      print(`    ${cat} (${count}) — ${theme.sounds[cat].description}`);
     }
 
     print("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-sounds",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Sound themes for Claude Code lifecycle hooks",
   "bin": {
     "claude-code-sounds": "bin/cli.js"

package/themes/wc3-peon/download.sh

@@ -5,6 +5,7 @@
 #
 set -e
 
+# shellcheck disable=SC2034  # passed by install.sh, reserved for theme use
 SOUNDS_DIR="$1"
 TMP_DIR="$2"
 
@@ -14,7 +15,7 @@ curl -sL -o "$ZIP" "https://sounds.spriters-resource.com/media/assets/422/425494
 
 if ! file "$ZIP" | grep -q "Zip"; then
   echo "  Error: Failed to download WC3 sound pack."
-  return 1
+  exit 1
 fi
 
 unzip -qo "$ZIP" \

package/themes/wc3-peon/theme.json

@@ -2,6 +2,7 @@
   "name": "WC3 Orc Peon",
   "description": "Warcraft 3 Orc unit soundbites — Peons, Grunts, Shamans, and more",
   "author": "ryparker",
+  "srcBase": "Orc",
   "sounds": {
     "start": {
       "description": "Session starting — being summoned",
@@ -34,7 +35,8 @@
     "stop": {
       "description": "Done responding — acknowledgment",
       "files": [
-        { "src": "Peon/PeonYesAttack2.wav", "name": "zug-zug.wav" },
+        { "src": "Grunt/GruntYes4.wav", "name": "zug-zug.wav" },
+        { "src": "Peon/PeonYesAttack2.wav", "name": "get-em.wav" },
         { "src": "Peon/PeonYesAttack1.wav", "name": "ok.wav" },
         { "src": "Peon/PeonYes1.wav", "name": "i-can-do-that.wav" },
         { "src": "Peon/PeonYes2.wav", "name": "be-happy-to.wav" },
@@ -52,7 +54,8 @@
         { "src": "Hellscream/GromWarcry1.wav", "name": "taste-the-fury.wav" },
         { "src": "Peon/PeonYesAttack3.wav", "name": "ill-try.wav" },
         { "src": "Peon/PeonWarcry1.wav", "name": "why-not.wav" },
-        { "src": "Peon/PeonYesAttack2.wav", "name": "zug-zug.wav" }
+        { "src": "Grunt/GruntYes4.wav", "name": "zug-zug.wav" },
+        { "src": "Peon/PeonYesAttack2.wav", "name": "get-em.wav" }
       ]
     },
     "idle": {

package/themes/zelda-oot/download.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+#
+# Downloads sound files for the zelda-oot theme.
+# Called by install.sh with $1 = target sounds directory, $2 = temp directory.
+#
+set -e
+
+# shellcheck disable=SC2034  # passed by install.sh, reserved for theme use
+SOUNDS_DIR="$1"
+TMP_DIR="$2"
+OOT_DIR="$TMP_DIR/OOT"
+
+mkdir -p "$OOT_DIR"
+
+BASE_URL="https://noproblo.dayjo.org/zeldasounds/oot"
+
+# All unique sound files needed by this theme
+FILES=(
+  OOT_Navi_Hey1.wav
+  OOT_Navi_Hello1.wav
+  OOT_Navi_Listen1.wav
+  OOT_Navi_Look1.wav
+  OOT_Navi_WatchOut1.wav
+  OOT_GreatFairy_Laugh1.wav
+  OOT_Chest_Big.wav
+  OOT_Chest_Small.wav
+  OOT_MainMenu_Select.wav
+  OOT_Dialogue_Next.wav
+  OOT_Dialogue_Done_Mono.wav
+  OOT_Get_Heart.wav
+  OOT_Get_SmallItem1.wav
+  OOT_Get_Rupee.wav
+  OOT_Secret_Mono.wav
+  OOT_Song_Correct_Mono.wav
+  OOT_Song_Error.wav
+  OOT_PauseMenu_Open_Mono.wav
+  OOT_PauseMenu_Close_Mono.wav
+  OOT_ZTarget_Enemy.wav
+  OOT_Sword_Draw.wav
+  OOT_Sword_Spin.wav
+  OOT_AdultLink_Attack1.wav
+  OOT_AdultLink_StrongAttack1.wav
+  OOT_AdultLink_Hurt1.wav
+  OOT_Fanfare_SmallItem.wav
+  OOT_Error.wav
+  OOT_LowHealth.wav
+  OOT_Talon_Snore.wav
+  OOT_Ganondorf_Heheh.wav
+)
+
+echo "  Downloading Zelda: Ocarina of Time sounds..."
+
+FAILED=0
+for FILE in "${FILES[@]}"; do
+  curl -sL -o "$OOT_DIR/$FILE" "$BASE_URL/$FILE"
+  if ! file "$OOT_DIR/$FILE" | grep -q "WAVE\|RIFF"; then
+    echo "    Warning: Failed to download $FILE"
+    rm -f "$OOT_DIR/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+if [ "$FAILED" -gt 0 ]; then
+  echo "  Warning: $FAILED file(s) failed to download."
+fi
+
+echo "  Download complete."

package/themes/zelda-oot/theme.json

@@ -0,0 +1,110 @@
+{
+  "name": "Zelda: Ocarina of Time",
+  "description": "Navi, Link, and iconic OOT jingles — Hey! Listen!",
+  "author": "ryparker",
+  "srcBase": "OOT",
+  "sounds": {
+    "start": {
+      "description": "Session starting — Navi greets you",
+      "files": [
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Navi_Hello1.wav", "name": "hello.wav" },
+        { "src": "OOT_Navi_Listen1.wav", "name": "listen.wav" },
+        { "src": "OOT_GreatFairy_Laugh1.wav", "name": "great-fairy-laugh.wav" },
+        { "src": "OOT_Chest_Big.wav", "name": "open-chest.wav" }
+      ]
+    },
+    "end": {
+      "description": "Session over — quest complete",
+      "files": [
+        { "src": "OOT_Fanfare_SmallItem.wav", "name": "item-fanfare.wav" },
+        { "src": "OOT_Secret_Mono.wav", "name": "secret-discovered.wav" },
+        { "src": "OOT_Dialogue_Done_Mono.wav", "name": "dialogue-done.wav" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — Navi warns you",
+      "files": [
+        { "src": "OOT_Navi_WatchOut1.wav", "name": "watch-out.wav" },
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Navi_Listen1.wav", "name": "listen.wav" },
+        { "src": "OOT_PauseMenu_Open_Mono.wav", "name": "pause-menu.wav" },
+        { "src": "OOT_ZTarget_Enemy.wav", "name": "z-target.wav" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — loot collected",
+      "files": [
+        { "src": "OOT_Secret_Mono.wav", "name": "secret-discovered.wav" },
+        { "src": "OOT_Get_SmallItem1.wav", "name": "get-item.wav" },
+        { "src": "OOT_Get_Rupee.wav", "name": "get-rupee.wav" },
+        { "src": "OOT_Chest_Small.wav", "name": "open-small-chest.wav" },
+        { "src": "OOT_Song_Correct_Mono.wav", "name": "song-correct.wav" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — Link attacks",
+      "files": [
+        { "src": "OOT_Sword_Draw.wav", "name": "sword-draw.wav" },
+        { "src": "OOT_AdultLink_Attack1.wav", "name": "link-attack.wav" },
+        { "src": "OOT_AdultLink_StrongAttack1.wav", "name": "link-strong-attack.wav" },
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Sword_Spin.wav", "name": "spin-attack.wav" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — Navi pesters you",
+      "files": [
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Navi_Listen1.wav", "name": "listen.wav" },
+        { "src": "OOT_Navi_WatchOut1.wav", "name": "watch-out.wav" },
+        { "src": "OOT_LowHealth.wav", "name": "low-health.wav" },
+        { "src": "OOT_Talon_Snore.wav", "name": "snore.wav" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — Link takes damage",
+      "files": [
+        { "src": "OOT_Error.wav", "name": "error.wav" },
+        { "src": "OOT_Song_Error.wav", "name": "song-error.wav" },
+        { "src": "OOT_AdultLink_Hurt1.wav", "name": "link-hurt.wav" },
+        { "src": "OOT_Ganondorf_Heheh.wav", "name": "ganondorf-laugh.wav" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — adventure continues",
+      "files": [
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Navi_Look1.wav", "name": "look.wav" },
+        { "src": "OOT_MainMenu_Select.wav", "name": "menu-select.wav" },
+        { "src": "OOT_Dialogue_Next.wav", "name": "dialogue-next.wav" },
+        { "src": "OOT_Get_Heart.wav", "name": "get-heart.wav" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — treasure acquired",
+      "files": [
+        { "src": "OOT_Fanfare_SmallItem.wav", "name": "item-fanfare.wav" },
+        { "src": "OOT_Secret_Mono.wav", "name": "secret-discovered.wav" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — health running low",
+      "files": [
+        { "src": "OOT_LowHealth.wav", "name": "low-health.wav" },
+        { "src": "OOT_PauseMenu_Close_Mono.wav", "name": "pause-close.wav" },
+        { "src": "OOT_Navi_WatchOut1.wav", "name": "watch-out.wav" },
+        { "src": "OOT_Error.wav", "name": "error.wav" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — Navi nags",
+      "files": [
+        { "src": "OOT_Navi_Hey1.wav", "name": "hey.wav" },
+        { "src": "OOT_Navi_Listen1.wav", "name": "listen.wav" },
+        { "src": "OOT_Navi_WatchOut1.wav", "name": "watch-out.wav" },
+        { "src": "OOT_LowHealth.wav", "name": "low-health.wav" }
+      ]
+    }
+  }
+}