klaudio 0.3.0 → 0.4.1

package/README.md

@@ -11,8 +11,8 @@ npx klaudio
 The interactive installer walks you through:
 
 1. **Choose scope** — install globally (`~/.claude`) or per-project (`.claude/`)
-2. **Pick a source** — use a built-in preset, scan your local games for sounds, or provide custom files
-3. **Preview & assign** — listen to sounds and assign them to events
+2. **Pick a source** — use a built-in preset, scan your Steam & Epic Games library for sounds, or provide custom files
+3. **Preview & assign** — listen to sounds and assign them to events (tab to switch between events)
 4. **Install** — writes Claude Code hooks to your `settings.json`
 
 ## Sound Sources
@@ -23,13 +23,14 @@ Ready-made sound packs (Retro 8-bit, Minimal Zen, Sci-Fi Terminal, Victory Fanfa
 
 ### Game Sound Scanner
 
-Scans your Steam and Epic Games libraries for audio files:
+Scans your local Steam and Epic Games libraries for audio files:
 
 - Finds loose audio files (`.wav`, `.mp3`, `.ogg`, `.flac`, `.aac`)
 - Extracts packed audio (Wwise `.wem`, FMOD `.bank`, `.fsb`) using [vgmstream](https://vgmstream.org/) (downloaded automatically)
+- Extracts Unity game audio from `.resource` files (PCM decoded directly, Vorbis converted via vgmstream)
 - Parses Wwise metadata (`SoundbanksInfo.json`) for descriptive filenames
 - Categorizes sounds (voice, ambient, music, SFX, UI, creature) for easy browsing
-- Caches extracted sounds in `~/.klonk/cache/` for instant reuse
+- Caches extracted sounds in `~/.klaudio/cache/` for instant reuse
 
 ### Custom Files
 
@@ -38,18 +39,19 @@ Point to your own `.wav`/`.mp3` files.
 ## Features
 
 - **Auto-preview** — sounds play automatically as you browse the list (toggle with `p`)
+- **Multi-game selection** — pick sounds from different games, tab between events
 - **Category filtering** — drill into voice, ambient, SFX, etc. when a game has enough variety
 - **Type-to-filter** — start typing to narrow down long lists
 - **10-second clamp** — long sounds are processed with ffmpeg: silence stripped, fade out baked in
 - **Background scanning** — game list updates live as directories are scanned
-- **Cross-platform** — Windows (PowerShell/ffplay), macOS (afplay/ffplay), Linux (aplay/ffplay)
+- **Pre-loads existing config** — re-running the installer shows your current sound selections
 
 ## Events
 
 | Event | Triggers when |
 |---|---|
-| Task Complete | Claude finishes a response |
 | Notification | Claude needs your attention |
+| Task Complete | Claude finishes a response |
 
 ## Uninstall
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klaudio",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Add sound effects to your coding sessions — play sounds when tasks complete, notifications arrive, and more",
   "type": "module",
   "bin": {

package/src/cache.js

@@ -2,7 +2,7 @@ import { readdir, mkdir, readFile, writeFile, stat, copyFile } from "node:fs/pro
 import { join, extname, basename, dirname } from "node:path";
 import { homedir } from "node:os";
 
-const CACHE_DIR = join(homedir(), ".klonk", "cache");
+const CACHE_DIR = join(homedir(), ".klaudio", "cache");
 
 /**
  * Category keywords to match against folder names, filenames, and Wwise event names.

package/src/cli.js

@@ -803,7 +803,7 @@ const ExtractingScreen = ({ game, onDone, onBack }) => {
           return;
         }
 
-        const outputDir = join(tmpdir(), "klonk-extract", game.name.replace(/[^a-zA-Z0-9]/g, "_"));
+        const outputDir = join(tmpdir(), "klaudio-extract", game.name.replace(/[^a-zA-Z0-9]/g, "_"));
         const allOutputs = [];
 
         // Unity .resource files — extract FSB5 banks directly (no vgmstream needed for PCM16)
@@ -995,7 +995,7 @@ const DoneScreen = ({ result }) => {
       ),
     ),
     h(Box, { marginTop: 1 },
-      h(Text, { dimColor: true }, "  To remove: npx klonk --uninstall"),
+      h(Text, { dimColor: true }, "  To remove: npx klaudio --uninstall"),
     ),
   );
 };
@@ -1037,13 +1037,13 @@ const UninstallApp = () => {
   if (phase === "done") {
     return h(Box, { flexDirection: "column" },
       h(Header, null),
-      h(Text, { color: "green", marginLeft: 2 }, "  ✓ Klonk hooks removed."),
+      h(Text, { color: "green", marginLeft: 2 }, "  ✓ Klaudio hooks removed."),
     );
   }
 
   return h(Box, { flexDirection: "column" },
     h(Header, null),
-    h(Text, { color: "yellow", marginLeft: 2 }, "  No Klonk configuration found."),
+    h(Text, { color: "yellow", marginLeft: 2 }, "  No Klaudio configuration found."),
   );
 };
 

package/src/extractor.js

@@ -5,7 +5,7 @@ import { join, extname, basename, resolve as resolvePath } from "node:path";
 import { platform, homedir, tmpdir } from "node:os";
 import { pipeline } from "node:stream/promises";
 
-const TOOLS_DIR = join(homedir(), ".klonk", "tools");
+const TOOLS_DIR = join(homedir(), ".klaudio", "tools");
 
 // Packed audio formats that vgmstream-cli can convert to WAV
 const PACKED_EXTENSIONS = new Set([".wem", ".bnk", ".bank", ".fsb", ".pck"]);
@@ -65,29 +65,31 @@ export async function getVgmstreamPath(onProgress) {
   await mkdir(TOOLS_DIR, { recursive: true });
 
   // Download the appropriate release
-  const releaseUrl = os === "win32"
+  const isWindows = os === "win32";
+  const releaseUrl = isWindows
     ? "https://github.com/vgmstream/vgmstream-releases/releases/download/nightly/vgmstream-win64.zip"
     : os === "darwin"
-      ? "https://github.com/vgmstream/vgmstream-releases/releases/download/nightly/vgmstream-macos.zip"
-      : "https://github.com/vgmstream/vgmstream-releases/releases/download/nightly/vgmstream-linux.zip";
+      ? "https://github.com/vgmstream/vgmstream-releases/releases/download/nightly/vgmstream-mac-cli.tar.gz"
+      : "https://github.com/vgmstream/vgmstream-releases/releases/download/nightly/vgmstream-linux-cli.tar.gz";
 
-  const zipPath = join(tmpdir(), "vgmstream.zip");
+  const archiveExt = isWindows ? ".zip" : ".tar.gz";
+  const archivePath = join(tmpdir(), `vgmstream${archiveExt}`);
 
   // Download using Node.js fetch
   const response = await fetch(releaseUrl, { redirect: "follow" });
   if (!response.ok) throw new Error(`Failed to download vgmstream: ${response.status}`);
 
-  const fileStream = createWriteStream(zipPath);
+  const fileStream = createWriteStream(archivePath);
   await pipeline(response.body, fileStream);
 
   if (onProgress) onProgress("Extracting vgmstream-cli...");
 
-  // Extract using tar (handles zip on modern systems) or PowerShell on Windows
-  if (os === "win32") {
+  // Extract: PowerShell for Windows, tar for macOS/Linux
+  if (isWindows) {
     await new Promise((resolve, reject) => {
       execFile("powershell.exe", [
         "-NoProfile", "-Command",
-        `Expand-Archive -Path '${zipPath}' -DestinationPath '${TOOLS_DIR}' -Force`,
+        `Expand-Archive -Path '${archivePath}' -DestinationPath '${TOOLS_DIR}' -Force`,
       ], { windowsHide: true }, (err) => {
         if (err) reject(err);
         else resolve();
@@ -95,13 +97,21 @@ export async function getVgmstreamPath(onProgress) {
     });
   } else {
     await new Promise((resolve, reject) => {
-      execFile("unzip", ["-o", zipPath, "-d", TOOLS_DIR], (err) => {
+      execFile("tar", ["xzf", archivePath, "-C", TOOLS_DIR], (err) => {
         if (err) reject(err);
         else resolve();
       });
     });
     // Make executable
     try { await chmod(toolPath, 0o755); } catch { /* ignore */ }
+    // Remove macOS quarantine attribute so Gatekeeper doesn't block execution
+    if (os === "darwin") {
+      try {
+        await new Promise((resolve) => {
+          execFile("xattr", ["-d", "com.apple.quarantine", toolPath], () => resolve());
+        });
+      } catch { /* ignore — attribute may not exist */ }
+    }
   }
 
   // Verify it exists

package/src/installer.js

@@ -62,19 +62,19 @@ export async function install({ scope, sounds }) {
     const hookEvent = event.hookEvent;
     const playCommand = getHookPlayCommand(soundPath);
 
-    // Check if there's already a klonk hook for this event
+    // Check if there's already a klaudio hook for this event
     if (!settings.hooks[hookEvent]) {
       settings.hooks[hookEvent] = [];
     }
 
-    // Remove any existing klonk entries
+    // Remove any existing klaudio entries
     settings.hooks[hookEvent] = settings.hooks[hookEvent].filter(
-      (entry) => !entry._klonk
+      (entry) => !entry._klaudio
     );
 
     // Add our hook
     settings.hooks[hookEvent].push({
-      _klonk: true,
+      _klaudio: true,
       matcher: "",
       hooks: [
         {
@@ -112,7 +112,7 @@ export async function getExistingSounds(scope) {
     for (const [eventId, event] of Object.entries(EVENTS)) {
       const hookEntries = settings.hooks[event.hookEvent];
       if (!hookEntries) continue;
-      const entry = hookEntries.find((e) => e._klonk);
+      const entry = hookEntries.find((e) => e._klaudio);
       if (!entry?.hooks?.[0]?.command) continue;
 
       // Extract file path from the play command
@@ -129,7 +129,7 @@ export async function getExistingSounds(scope) {
 }
 
 /**
- * Uninstall klonk hooks from settings.
+ * Uninstall klaudio hooks from settings.
  */
 export async function uninstall(scope) {
   const claudeDir = getTargetDir(scope);
@@ -142,7 +142,7 @@ export async function uninstall(scope) {
     if (settings.hooks) {
       for (const [event, entries] of Object.entries(settings.hooks)) {
         settings.hooks[event] = entries.filter(
-          (entry) => !entry._klonk
+          (entry) => !entry._klaudio
         );
         if (settings.hooks[event].length === 0) {
           delete settings.hooks[event];

package/src/player.js

@@ -301,7 +301,7 @@ export async function processSound(filePath) {
 
   // Build a deterministic output path based on input file hash
   const hash = createHash("md5").update(absPath).digest("hex").slice(0, 12);
-  const outDir = join(tmpdir(), "klonk-processed");
+  const outDir = join(tmpdir(), "klaudio-processed");
   const outName = `${basename(absPath, extname(absPath))}_${hash}.wav`;
   const outPath = join(outDir, outName);