claude-code-sounds 1.3.0 → 1.4.0

package/README.md

@@ -22,7 +22,7 @@ npx claude-code-sounds
 
 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+.
+Requires macOS (uses `afplay`) and Node.js 20+.
 
 For scripted or CI usage, skip all prompts with `--yes`:
 
@@ -85,38 +85,30 @@ Each theme maps sounds across all 11 Claude Code lifecycle events. Preview insta
 
 ## Creating a Theme
 
-Themes live in `themes/<name>/` with two files:
+Themes live in `themes/<name>/` with two items:
 
 ### `theme.json`
 
-Defines metadata and maps source files to hook categories:
+Defines metadata and maps sound files to hook categories:
 
 ```json
 {
   "name": "My Theme",
   "description": "A short description",
-  "srcBase": "MyTheme",
   "sounds": {
     "start": {
       "description": "Session starting",
       "files": [
-        { "src": "path/to/file.wav", "name": "descriptive-name.wav" }
+        { "name": "descriptive-name.wav" }
       ]
     }
   }
 }
 ```
 
-- **`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
+### `sounds/`
 
-### `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/<srcBase>/<src path>` (matching the `srcBase` and `src` values in `theme.json`).
+Place audio files (`.wav` or `.mp3`) in `themes/<name>/sounds/` with filenames matching the `name` field in `theme.json`.
 
 ## How It Works
 
@@ -148,4 +140,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 its respective owners: Blizzard Entertainment (Warcraft), Nintendo (Zelda, Mario, Pokemon), Lucasfilm/Disney (Star Wars), Konami (Metal Gear Solid), and Valve (Portal).
+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).

package/bin/cli.js

@@ -501,15 +501,17 @@ function showHelp() {
 
   Usage:
     npx claude-code-sounds              Interactive install
+    npx claude-code-sounds --theme mgs  Install a specific theme directly
     npx claude-code-sounds --yes        Install defaults, skip 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 this help
 
   Flags:
-    -y, --yes       Skip all prompts, use defaults
-    -l, --list      List available themes
-    -h, --help      Show this help
+    -t, --theme <name>  Install a specific theme by name
+    -y, --yes           Skip all prompts, use defaults
+    -l, --list          List available themes
+    -h, --help          Show this help
 `);
 }
 
@@ -934,10 +936,50 @@ const args = process.argv.slice(2);
 const flags = new Set(args);
 const autoYes = flags.has("--yes") || flags.has("-y");
 
+// Parse --theme <name> or --theme=<name> or -t <name>
+let themeArg = null;
+for (let i = 0; i < args.length; i++) {
+  if ((args[i] === "--theme" || args[i] === "-t") && args[i + 1]) {
+    themeArg = args[i + 1];
+    break;
+  }
+  if (args[i].startsWith("--theme=")) {
+    themeArg = args[i].slice("--theme=".length);
+    break;
+  }
+}
+
 if (flags.has("--help") || flags.has("-h")) {
   showHelp();
 } else if (flags.has("--list") || flags.has("-l")) {
   showList();
+} else if (themeArg) {
+  (async () => {
+    p.intro(color.bold("claude-code-sounds"));
+    checkDependencies();
+
+    const themes = listThemes();
+    // Try exact match first, then case-insensitive
+    let theme = themes.find((t) => t.name === themeArg);
+    if (!theme) {
+      const lower = themeArg.toLowerCase();
+      theme = themes.find((t) => t.name.toLowerCase() === lower);
+    }
+
+    if (!theme) {
+      p.cancel(
+        `Theme "${themeArg}" not found.\n${color.gray(p.S_BAR)}\n${color.gray(p.S_BAR)}  Available: ${themes.map((t) => t.name).join(", ")}`
+      );
+      process.exit(1);
+    }
+
+    await quickInstall(theme);
+    p.outro("Start a new Claude Code session to hear it.");
+  })().catch((err) => {
+    killPreview();
+    p.cancel(err.message);
+    process.exit(1);
+  });
 } else if (flags.has("--uninstall") || flags.has("--remove")) {
   p.intro(color.bold("claude-code-sounds"));
   uninstallAll();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-sounds",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Sound themes for Claude Code lifecycle hooks",
   "bin": {
     "claude-code-sounds": "bin/cli.js"
@@ -27,7 +27,7 @@
     "images/"
   ],
   "engines": {
-    "node": ">=16"
+    "node": ">=20"
   },
   "dependencies": {
     "@clack/core": "^1.0.1",