klaudio 0.2.0-c2cee62 → 0.4.0

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.2.0-c2cee62",
+  "version": "0.4.0",
   "description": "Add sound effects to your coding sessions — play sounds when tasks complete, notifications arrive, and more",
   "type": "module",
   "bin": {
@@ -41,4 +41,4 @@
     "type": "git",
     "url": "https://github.com/needle-tools/klaudio.git"
   }
-}
+}

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

@@ -599,11 +599,16 @@ const GameSoundsScreen = ({ game, sounds, onSelectSound, onDone, onBack }) => {
       ...eventIds.map((eid, i) => {
         const assigned = sounds[eid];
         const isCurrent = i === currentEvent;
+        const truncName = assigned ? basename(assigned).slice(0, 20) : null;
+        const prefix = isCurrent ? "▸" : assigned ? "✓" : "·";
+        const label = truncName
+          ? `${prefix} ${EVENTS[eid].name}: ${truncName}`
+          : `${prefix} ${EVENTS[eid].name}`;
         return h(Text, {
           key: eid,
           bold: isCurrent,
           color: isCurrent ? ACCENT : assigned ? "green" : "gray",
-        }, isCurrent ? `▸ ${EVENTS[eid].name}` : assigned ? `✓ ${EVENTS[eid].name}: ${basename(assigned)}` : `· ${EVENTS[eid].name}`);
+        }, label);
       }),
       h(Text, {
         key: "_done",
@@ -798,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)
@@ -990,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"),
     ),
   );
 };
@@ -1032,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"]);

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);