claude-code-sounds 1.6.0 → 1.7.0

package/README.md

@@ -10,7 +10,7 @@
 
 Plays sound effects when sessions start, prompts are submitted, responses finish, errors occur, and more.
 
-Ships with 15 themes. Bring your own sounds or create new ones.
+Ships with 17 themes. Bring your own sounds or create new ones.
 
 *"Something need doing?"*
 
@@ -48,6 +48,7 @@ The bash installer requires `jq` (`brew install jq`).
 | **Command & Conquer** (`cnc`) | 52 | *"Construction complete"* — EVA announcements, unit voices, and Red Alert |
 | **Diablo 2** (`diablo2`) | 46 | *"Stay awhile and listen"* — Deckard Cain, item drops, and the Prime Evils |
 | **Halo** (`halo`) | 52 | *"Wake me when you need me"* — Master Chief, Cortana, and the multiplayer announcer |
+| **League of Legends** (`league-of-legends`) | 43 | *"Welcome to Summoner's Rift"* — Champion voice lines, announcer calls, and ping sounds |
 | **Metal Gear Solid** (`mgs`) | 40 | *"Kept you waiting, huh?"* — Codec calls, alert sounds, and Snake |
 | **Pokemon Gen 3** (`pokemon-gen3`) | 51 | *"A wild TREECKO appeared!"* — GBA battle cries, Hoenn fanfares, and RSE bleeps |
 | **Portal** (`portal`) | 42 | *"Are you still there?"* — Turrets, portal guns, and Aperture Science |
@@ -57,6 +58,7 @@ The bash installer requires `jq` (`brew install jq`).
 | **Super Mario Bros** (`mario`) | 47 | *"Let's-a go!"* — Coins, power-ups, and Mario's voice from NES to N64 |
 | **Warhammer 40k** (`wh40k`) | 50 | *"For the Emperor!"* — Space Marines, Chaos war cries, and Ork shouts |
 | **WC3 Orc Peon** (`wc3-peon`) | 57 | *"Something need doing?"* — Peons, Grunts, Shamans, and Grom Hellscream |
+| **Zelda: Breath of the Wild** (`zelda-botw`) | 42 | *"It's dangerous to go alone"* — Sheikah Slate sounds, Korok discoveries, and Guardian alerts |
 | **Zelda: Ocarina of Time** (`zelda-oot`) | 47 | *"Hey! Listen!"* — Navi, Link, and iconic OOT jingles |
 
 Each theme maps sounds across all 11 Claude Code lifecycle events.
@@ -184,6 +186,6 @@ Place audio files (`.wav` or `.mp3`) in `themes/<name>/sounds/` with filenames m
 
 This project is an unofficial fan project provided free of charge for personal, non-commercial use. It is not affiliated with, endorsed by, or sponsored by any game publisher or rights holder.
 
-All game audio is the property of its respective owners: Blizzard Entertainment (Warcraft, StarCraft, Diablo), Nintendo/Game Freak (Zelda, Mario, Pokemon), Lucasfilm/Disney (Star Wars), Konami (Metal Gear Solid), Valve (Portal), Electronic Arts/Westwood Studios (Command & Conquer), Xbox Game Studios/Ensemble Studios (Age of Empires), Games Workshop/Relic Entertainment (Warhammer 40,000), Xbox Game Studios/Bungie/343 Industries (Halo), Activision/Infinity Ward (Call of Duty), TriStar Pictures (Short Circuit). All trademarks and registered trademarks are the property of their respective owners.
+All game audio is the property of its respective owners: Blizzard Entertainment (Warcraft, StarCraft, Diablo), Nintendo/Game Freak (Zelda, Mario, Pokemon), Lucasfilm/Disney (Star Wars), Konami (Metal Gear Solid), Valve (Portal), Electronic Arts/Westwood Studios (Command & Conquer), Xbox Game Studios/Ensemble Studios (Age of Empires), Games Workshop/Relic Entertainment (Warhammer 40,000), Xbox Game Studios/Bungie/343 Industries (Halo), Activision/Infinity Ward (Call of Duty), Riot Games (League of Legends), TriStar Pictures (Short Circuit). All trademarks and registered trademarks are the property of their respective owners.
 
 If you are a rights holder and would like content removed, please [open an issue](https://github.com/ryparker/claude-code-sounds/issues) and it will be taken down promptly.

package/bin/cli.js

@@ -2,7 +2,7 @@
 
 const fs = require("fs");
 const path = require("path");
-const { execSync, spawn } = require("child_process");
+const { execFileSync, spawn } = require("child_process");
 const p = require("@clack/prompts");
 const { Prompt } = require("@clack/core");
 const color = require("picocolors");
@@ -25,13 +25,9 @@ const installHooksConfig = () => lib.installHooksConfig(paths);
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
-function exec(cmd, opts = {}) {
-  return execSync(cmd, { encoding: "utf-8", stdio: "pipe", ...opts });
-}
-
 function hasCommand(name) {
   try {
-    exec(`which ${name}`);
+    execFileSync("which", [name], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -179,8 +175,8 @@ class SoundGrid extends Prompt {
 
         if (currentRowIdx < scrollTop) {
           scrollTop = Math.max(0, currentRowIdx - 1);
-        } else if (currentRowIdx >= scrollTop + maxVisible) {
-          scrollTop = currentRowIdx - maxVisible + 1;
+        } else if (currentRowIdx >= scrollTop + maxVisible - 2) {
+          scrollTop = currentRowIdx - maxVisible + 3;
         }
         if (scrollTop > 0 && myRows[scrollTop]?.type === 'sound') {
           for (let i = scrollTop - 1; i >= Math.max(0, scrollTop - 2); i--) {

package/bin/lib.js

@@ -1,6 +1,7 @@
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
+const { execFileSync } = require("child_process");
 
 // ─── Path Factory ────────────────────────────────────────────────────────────
 
@@ -67,7 +68,12 @@ function listThemes(paths) {
   for (const name of fs.readdirSync(paths.THEMES_DIR)) {
     const themeJson = path.join(paths.THEMES_DIR, name, "theme.json");
     if (!fs.existsSync(themeJson)) continue;
-    const meta = JSON.parse(fs.readFileSync(themeJson, "utf-8"));
+    let meta;
+    try {
+      meta = JSON.parse(fs.readFileSync(themeJson, "utf-8"));
+    } catch {
+      continue;
+    }
     let soundCount = 0;
     if (meta.sounds) {
       for (const cat of Object.values(meta.sounds)) {
@@ -97,26 +103,34 @@ function resolveThemeSoundPath(themeName, fileName, paths) {
 
 function readSettings(paths) {
   if (fs.existsSync(paths.SETTINGS_PATH)) {
-    return JSON.parse(fs.readFileSync(paths.SETTINGS_PATH, "utf-8"));
+    try {
+      return JSON.parse(fs.readFileSync(paths.SETTINGS_PATH, "utf-8"));
+    } catch {}
   }
   return {};
 }
 
 function writeSettings(settings, paths) {
   mkdirp(paths.CLAUDE_DIR);
-  fs.writeFileSync(paths.SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+  const tmp = paths.SETTINGS_PATH + ".tmp";
+  fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+  fs.renameSync(tmp, paths.SETTINGS_PATH);
 }
 
 function readInstalled(paths) {
   if (fs.existsSync(paths.INSTALLED_PATH)) {
-    return JSON.parse(fs.readFileSync(paths.INSTALLED_PATH, "utf-8"));
+    try {
+      return JSON.parse(fs.readFileSync(paths.INSTALLED_PATH, "utf-8"));
+    } catch {}
   }
   return null;
 }
 
 function writeInstalled(data, paths) {
   mkdirp(paths.SOUNDS_DIR);
-  fs.writeFileSync(paths.INSTALLED_PATH, JSON.stringify(data, null, 2) + "\n");
+  const tmp = paths.INSTALLED_PATH + ".tmp";
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n");
+  fs.renameSync(tmp, paths.INSTALLED_PATH);
 }
 
 function isMuted(paths) {
@@ -168,6 +182,20 @@ function _updateHookScript(paths) {
   }
 }
 
+function compileMicHelper(paths) {
+  const src = path.join(paths.PKG_DIR, "helpers", "mic-active.swift");
+  const dest = path.join(paths.SOUNDS_DIR, ".mic-active");
+  if (!fs.existsSync(src)) return false;
+  try {
+    mkdirp(paths.SOUNDS_DIR);
+    execFileSync("swiftc", ["-O", src, "-o", dest], { stdio: "pipe" });
+    fs.chmodSync(dest, 0o755);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ─── Detect Existing Install ─────────────────────────────────────────────────
 
 function detectExistingInstall(paths) {
@@ -221,23 +249,26 @@ function installSounds(selections, paths) {
     const catDir = path.join(paths.SOUNDS_DIR, cat);
     mkdirp(catDir);
 
-    try {
-      for (const f of fs.readdirSync(catDir)) {
-        if (f.endsWith(".wav") || f.endsWith(".mp3")) {
-          fs.unlinkSync(path.join(catDir, f));
-        }
-      }
-    } catch {}
-
+    // Copy new files first
+    const newFiles = new Set();
     for (const item of items) {
       const srcPath = resolveThemeSoundPath(item.themeName, item.fileName, paths);
       const destPath = path.join(catDir, item.fileName);
-
       if (fs.existsSync(srcPath)) {
         fs.copyFileSync(srcPath, destPath);
         total++;
       }
+      newFiles.add(item.fileName);
     }
+
+    // Then remove old files not in the new set
+    try {
+      for (const f of fs.readdirSync(catDir)) {
+        if ((f.endsWith(".wav") || f.endsWith(".mp3")) && !newFiles.has(f)) {
+          fs.unlinkSync(path.join(catDir, f));
+        }
+      }
+    } catch {}
   }
 
   return total;
@@ -270,6 +301,9 @@ function installHooksConfig(paths) {
   if (!isDnd(paths)) {
     setDnd(true, paths);
   }
+
+  // Compile mic-active helper (auto-mute when microphone is in use)
+  compileMicHelper(paths);
 }
 
 function uninstallAll(paths) {
@@ -346,6 +380,7 @@ module.exports = {
   detectExistingInstall,
   installSounds,
   installHooksConfig,
+  compileMicHelper,
   uninstallAll,
   quickInstall,
 };

package/hooks/play-sound.sh

@@ -15,6 +15,10 @@ if [[ -f "$SOUNDS_DIR/.dnd" ]]; then
   done < "$SOUNDS_DIR/.dnd"
 fi
 
+# Auto-mute: skip when microphone is in use (e.g. Superwhisper, dictation)
+MIC_CHECK="$SOUNDS_DIR/.mic-active"
+[[ -x "$MIC_CHECK" ]] && "$MIC_CHECK" > /dev/null 2>&1 && exit 0
+
 [[ -z "$CATEGORY" ]] && exit 0
 DIR="$SOUNDS_DIR/$CATEGORY"
 [[ ! -d "$DIR" ]] && exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-sounds",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Sound themes for Claude Code lifecycle hooks",
   "bin": {
     "claude-code-sounds": "bin/cli.js"
@@ -23,6 +23,7 @@
   "files": [
     "bin/",
     "commands/",
+    "helpers/",
     "hooks/",
     "themes/",
     "images/"

package/themes/aoe2/theme.json

@@ -71,7 +71,8 @@
         { "name": "unit-created.mp3" },
         { "name": "attack-enemy-now.mp3" },
         { "name": "taunt-wood-please.mp3" },
-        { "name": "taunt-stone-please.mp3" }
+        { "name": "taunt-stone-please.mp3" },
+        { "name": "stable.mp3" }
       ]
     },
     "error": {