klaudio 0.12.7 → 0.13.1

package/bin/cli.js

@@ -19,15 +19,18 @@ if (process.argv[2] === "notify") {
   process.exit(0);
 }
 
-// Subcommand: klaudio say "text" [--voice <voice>]
+// Subcommand: klaudio say "text" [--voice <voice>] [--speed <speed>]
 if (process.argv[2] === "say") {
   const args = process.argv.slice(3);
   const text = args.find((a) => !a.startsWith("--"));
   const voice = args.find((a) => a.startsWith("--voice="))?.slice(8)
     || args[args.indexOf("--voice") + 1];
+  const speedArg = args.find((a) => a.startsWith("--speed="))?.slice(8)
+    || args[args.indexOf("--speed") + 1];
+  const speed = speedArg ? parseFloat(speedArg) : undefined;
   if (text) {
     const { speak } = await import("../src/tts.js");
-    await speak(text, { voice });
+    await speak(text, { voice, speed });
   }
   // Hard exit: skip native module destructors (onnxruntime crashes during cleanup)
   process.exit(0);

package/package.json

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

package/src/cli.js

@@ -2,7 +2,7 @@ import React, { useState, useEffect, useCallback, useRef, useMemo } from "react"
 import { render, Box, Text, useInput, useApp } from "ink";
 import Spinner from "ink-spinner";
 import { PRESETS, EVENTS } from "./presets.js";
-import { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE, isKokoroAvailable } from "./tts.js";
+import { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE, isKokoroAvailable, ensureKokoroInstalled } from "./tts.js";
 import { playSoundWithCancel, getWavDuration } from "./player.js";
 import { getAvailableGames, getSystemSounds } from "./scanner.js";
 import { install, uninstall, getExistingSounds, checkHooksOutdated } from "./installer.js";
@@ -137,7 +137,9 @@ const NavHint = ({ back = true, extra = "" }) =>
   );
 
 // ── Screen: Scope ───────────────────────────────────────────────
-const ScopeScreen = ({ onNext, onMusic, onUpdate, tts, onToggleTts, voice, hasKokoro, onCycleVoice, outdatedReasons }) => {
+const SPEED_OPTIONS = [0.8, 0.9, 1.0, 1.1, 1.2, 1.3, 1.5];
+
+const ScopeScreen = ({ onNext, onMusic, onUpdate, tts, onToggleTts, voice, speed, hasKokoro, onCycleVoice, onCycleSpeed, onInstallKokoro, installingKokoro, outdatedReasons }) => {
   const isOutdated = outdatedReasons && outdatedReasons.length > 0;
   const items = [
     ...(isOutdated ? [{ label: "⬆ Apply updates", value: "_update" }] : []),
@@ -166,6 +168,10 @@ const ScopeScreen = ({ onNext, onMusic, onUpdate, tts, onToggleTts, voice, hasKo
       import("../src/tts.js").then(({ speak }) =>
         speak(`Hi, I'm ${nextVoice.name}`, { voice: nextVoice.id })
       ).finally(() => setPreviewing(false));
+    } else if (input === "v" && tts && !hasKokoro && !installingKokoro) {
+      onInstallKokoro();
+    } else if (input === "s" && tts && hasKokoro) {
+      onCycleSpeed();
     } else if (key.return) {
       const v = items[sel].value;
       if (v === "_update") onUpdate();
@@ -207,6 +213,18 @@ const ScopeScreen = ({ onNext, onMusic, onUpdate, tts, onToggleTts, voice, hasKo
       ),
       h(Text, { dimColor: true }, "  (v to change & preview)"),
     ) : null,
+    tts && hasKokoro ? h(Box, { marginLeft: 4 },
+      h(Text, { color: ACCENT }, `⚡ Speed: ${speed}x`),
+      h(Text, { dimColor: true }, "  (s to change)"),
+    ) : null,
+    tts && !hasKokoro ? h(Box, { marginLeft: 4 },
+      installingKokoro
+        ? h(Text, { color: "yellow" }, h(Spinner, { type: "dots" }), " Installing Kokoro HD voices...")
+        : h(React.Fragment, null,
+            h(Text, { color: "yellow" }, "🎙 HD voices available"),
+            h(Text, { dimColor: true }, "  (v to install Kokoro — 12 voices, ~25MB)"),
+          ),
+    ) : null,
   );
 };
 
@@ -1421,11 +1439,13 @@ const ExtractingScreen = ({ game, onDone, onBack }) => {
 };
 
 // ── Screen: Confirm ─────────────────────────────────────────────
-const ConfirmScreen = ({ scope, sounds, tts, voice, hasKokoro, onToggleTts, onCycleVoice, onConfirm, onBack }) => {
+const ConfirmScreen = ({ scope, sounds, tts, voice, speed, hasKokoro, onToggleTts, onCycleVoice, onCycleSpeed, onInstallKokoro, installingKokoro, onConfirm, onBack }) => {
   useInput((input, key) => {
     if (key.escape) onBack();
     else if (input === "t") onToggleTts();
     else if (input === "v" && tts && hasKokoro) onCycleVoice();
+    else if (input === "s" && tts && hasKokoro) onCycleSpeed();
+    else if (input === "v" && tts && !hasKokoro && !installingKokoro) onInstallKokoro();
   });
 
   const items = [
@@ -1457,6 +1477,18 @@ const ConfirmScreen = ({ scope, sounds, tts, voice, hasKokoro, onToggleTts, onCy
         ),
         h(Text, { dimColor: true }, "  (v to change voice)"),
       ) : null,
+      tts && hasKokoro ? h(Box, { marginLeft: 4 },
+        h(Text, { color: ACCENT }, `⚡ Speed: ${speed}x`),
+        h(Text, { dimColor: true }, "  (s to change)"),
+      ) : null,
+      tts && !hasKokoro ? h(Box, { marginLeft: 4 },
+        installingKokoro
+          ? h(Text, { color: "yellow" }, h(Spinner, { type: "dots" }), " Installing Kokoro HD voices...")
+          : h(React.Fragment, null,
+              h(Text, { color: "yellow" }, "🎙 HD voices available"),
+              h(Text, { dimColor: true }, "  (v to install Kokoro — 12 voices, ~25MB)"),
+            ),
+      ) : null,
     ),
     h(Box, { marginTop: 1, marginLeft: 2 },
       h(SelectInput, { indicatorComponent: Indicator, itemComponent: Item, items, onSelect: (item) => {
@@ -1469,13 +1501,13 @@ const ConfirmScreen = ({ scope, sounds, tts, voice, hasKokoro, onToggleTts, onCy
 };
 
 // ── Screen: Installing ──────────────────────────────────────────
-const InstallingScreen = ({ scope, sounds, tts, voice, onDone }) => {
+const InstallingScreen = ({ scope, sounds, tts, voice, speed, onDone }) => {
   useEffect(() => {
     const validSounds = {};
     for (const [eventId, path] of Object.entries(sounds)) {
       if (path) validSounds[eventId] = path;
     }
-    install({ scope, sounds: validSounds, tts, voice }).then(onDone).catch((err) => {
+    install({ scope, sounds: validSounds, tts, voice, speed }).then(onDone).catch((err) => {
       onDone({ error: err.message });
     });
   }, []);
@@ -1581,7 +1613,9 @@ const InstallApp = () => {
   const [installResult, setInstallResult] = useState(null);
   const [tts, setTts] = useState(true);
   const [voice, setVoice] = useState(KOKORO_DEFAULT_VOICE);
+  const [speed, setSpeed] = useState(1.0);
   const [hasKokoro, setHasKokoro] = useState(false);
+  const [installingKokoro, setInstallingKokoro] = useState(false);
   const [outdatedReasons, setOutdatedReasons] = useState([]);
   const [musicFiles, setMusicFiles] = useState([]);
   const [musicGameName, setMusicGameName] = useState(null);
@@ -1608,19 +1642,33 @@ const InstallApp = () => {
     if (preset) setSounds({ ...preset.sounds });
   }, []);
 
+  const handleInstallKokoro = useCallback(() => {
+    setInstallingKokoro(true);
+    ensureKokoroInstalled()
+      .then(() => { setHasKokoro(true); setInstallingKokoro(false); })
+      .catch(() => { setInstallingKokoro(false); });
+  }, []);
+
   const content = (() => {
     switch (screen) {
       case SCREEN.SCOPE:
         return h(ScopeScreen, {
           tts,
           voice,
+          speed,
           hasKokoro,
+          installingKokoro,
           outdatedReasons,
           onToggleTts: () => setTts((v) => !v),
           onCycleVoice: () => setVoice((v) => {
             const idx = KOKORO_VOICES.findIndex((x) => x.id === v);
             return KOKORO_VOICES[(idx + 1) % KOKORO_VOICES.length].id;
           }),
+          onCycleSpeed: () => setSpeed((s) => {
+            const idx = SPEED_OPTIONS.indexOf(s);
+            return SPEED_OPTIONS[(idx + 1) % SPEED_OPTIONS.length];
+          }),
+          onInstallKokoro: handleInstallKokoro,
           onNext: (s) => {
             setScope(s);
             // Refresh sounds/outdated for the selected scope
@@ -1744,12 +1792,19 @@ const InstallApp = () => {
           sounds,
           tts,
           voice,
+          speed,
           hasKokoro,
+          installingKokoro,
           onToggleTts: () => setTts((v) => !v),
           onCycleVoice: () => setVoice((v) => {
             const idx = KOKORO_VOICES.findIndex((x) => x.id === v);
             return KOKORO_VOICES[(idx + 1) % KOKORO_VOICES.length].id;
           }),
+          onCycleSpeed: () => setSpeed((s) => {
+            const idx = SPEED_OPTIONS.indexOf(s);
+            return SPEED_OPTIONS[(idx + 1) % SPEED_OPTIONS.length];
+          }),
+          onInstallKokoro: handleInstallKokoro,
           onConfirm: () => setScreen(SCREEN.INSTALLING),
           onBack: () => {
             if (selectedGame) setScreen(SCREEN.GAME_SOUNDS);
@@ -1763,6 +1818,7 @@ const InstallApp = () => {
           sounds,
           tts,
           voice,
+          speed,
           onDone: (result) => {
             setInstallResult(result);
             setScreen(SCREEN.DONE);

package/src/extractor.js

@@ -139,8 +139,7 @@ export async function findPackedAudioFiles(gamePath, maxFiles = 50) {
         } else if (entry.isFile()) {
           const ext = extname(entry.name).toLowerCase();
           // Formats vgmstream-cli can convert directly
-          // (.bnk needs bnkextr preprocessing — skip for now)
-          if (ext === ".wem" || ext === ".fsb" || ext === ".bank" || ext === ".bun" || ext === ".pck") {
+          if (ext === ".wem" || ext === ".fsb" || ext === ".bank" || ext === ".bun" || ext === ".pck" || ext === ".bnk") {
             results.push({ path: fullPath, name: entry.name, dir });
           }
         }

package/src/installer.js

@@ -25,8 +25,9 @@ function getTargetDir(scope) {
  * @param {string} options.scope - "global" or "project"
  * @param {Record<string, string>} options.sounds - Map of event ID -> source sound file path
  * @param {boolean} [options.tts] - Enable TTS voice summary on task complete
+ * @param {number} [options.speed] - Voice speed multiplier (default 1.0)
  */
-export async function install({ scope, sounds, tts = false, voice } = {}) {
+export async function install({ scope, sounds, tts = false, voice, speed } = {}) {
   const claudeDir = getTargetDir(scope);
   const soundsDir = join(claudeDir, "sounds");
   const settingsFile = join(claudeDir, "settings.json");
@@ -73,7 +74,7 @@ export async function install({ scope, sounds, tts = false, voice } = {}) {
     const hookEvent = event.hookEvent;
     // Enable TTS only for the "stop" event (task complete)
     const useTts = tts && eventId === "stop";
-    const playCommand = getHookPlayCommand(soundPath, { tts: useTts, voice });
+    const playCommand = getHookPlayCommand(soundPath, { tts: useTts, voice, speed });
 
     // Check if there's already a klaudio hook for this event
     if (!settings.hooks[hookEvent]) {
@@ -119,6 +120,7 @@ export async function install({ scope, sounds, tts = false, voice } = {}) {
 async function installApprovalHooks(settings, soundPath, claudeDir) {
   const normalized = soundPath.replace(/\\/g, "/");
   const scriptPath = join(claudeDir, "approval-notify.sh").replace(/\\/g, "/");
+  const cliPath = new URL("../bin/cli.js", import.meta.url).pathname;
 
   // Write the timer script
   const script = `#!/usr/bin/env bash
@@ -127,6 +129,7 @@ async function installApprovalHooks(settings, soundPath, claudeDir) {
 DELAY=120
 MARKER="/tmp/.claude-approval-pending"
 SOUND="${normalized}"
+CLI="${cliPath}"
 
 case "$1" in
   start)
@@ -139,9 +142,9 @@ case "$1" in
       if [ -f "$MARKER" ] && [ "$(head -1 "$MARKER" 2>/dev/null)" = "$TOKEN" ]; then
         PROJECT=$(tail -1 "$MARKER" 2>/dev/null | sed 's|.*[/\\\\]||')
         rm -f "$MARKER"
-        npx klaudio play "$SOUND" 2>/dev/null
-        npx klaudio notify "\${PROJECT:-project}" "Waiting for your approval" 2>/dev/null
-        npx klaudio say "\${PROJECT:-project} needs your attention" 2>/dev/null
+        node "$CLI" play "$SOUND" 2>/dev/null
+        node "$CLI" notify "\${PROJECT:-project}" "Waiting for your approval" 2>/dev/null
+        node "$CLI" say "\${PROJECT:-project} needs your attention" 2>/dev/null
       fi
     ) &
     ;;

package/src/player.js

@@ -371,20 +371,22 @@ export async function handlePlayCommand(args) {
   const soundFile = args.find((a) => !a.startsWith("-"));
   const tts = args.includes("--tts");
 
-  // Read stdin (hook JSON) non-blocking
+  // Read stdin (hook JSON) only when TTS or notifications need it
   let hookData = {};
-  try {
-    const chunks = [];
-    process.stdin.setEncoding("utf-8");
-    // Read whatever is available with a short timeout
-    const stdinData = await new Promise((res) => {
-      const timer = setTimeout(() => { process.stdin.pause(); res(chunks.join("")); }, 500);
-      process.stdin.on("data", (chunk) => chunks.push(chunk));
-      process.stdin.on("end", () => { clearTimeout(timer); res(chunks.join("")); });
-      process.stdin.resume();
-    });
-    if (stdinData.trim()) hookData = JSON.parse(stdinData);
-  } catch { /* no stdin or invalid JSON */ }
+  if (tts || args.includes("--notify")) {
+    try {
+      const chunks = [];
+      process.stdin.setEncoding("utf-8");
+      // Read whatever is available with a short timeout
+      const stdinData = await new Promise((res) => {
+        const timer = setTimeout(() => { process.stdin.pause(); res(chunks.join("")); }, 500);
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => { clearTimeout(timer); res(chunks.join("")); });
+        process.stdin.resume();
+      });
+      if (stdinData.trim()) hookData = JSON.parse(stdinData);
+    } catch { /* no stdin or invalid JSON */ }
+  }
 
   const notify = args.includes("--notify");
 
@@ -469,12 +471,15 @@ export async function handlePlayCommand(args) {
     await soundPromise;
     const voice = args.find((a) => a.startsWith("--voice="))?.slice(8)
       || args[args.indexOf("--voice") + 1];
+    const speedArg = args.find((a) => a.startsWith("--speed="))?.slice(8)
+      || args[args.indexOf("--speed") + 1];
+    const speed = speedArg ? parseFloat(speedArg) : undefined;
     // Spawn a detached child process for TTS so the hook can exit immediately
     const { spawn } = await import("node:child_process");
     const child = spawn(process.execPath, [
       "--input-type=module",
       "-e",
-      `import{speak}from"${import.meta.resolve("./tts.js")}";await speak(${JSON.stringify(spoken)},{voice:${JSON.stringify(voice || undefined)}});`,
+      `import{speak}from"${import.meta.resolve("./tts.js")}";await speak(${JSON.stringify(spoken)},{voice:${JSON.stringify(voice || undefined)},speed:${JSON.stringify(speed || undefined)}});`,
     ], {
       detached: true,
       stdio: "ignore",
@@ -488,10 +493,14 @@ export async function handlePlayCommand(args) {
 /**
  * Generate the shell command string for use in Claude Code hooks.
  */
-export function getHookPlayCommand(soundFilePath, { tts = false, voice, notify = true } = {}) {
+export function getHookPlayCommand(soundFilePath, { tts = false, voice, speed, notify = true } = {}) {
   const normalized = soundFilePath.replace(/\\/g, "/");
   const ttsFlag = tts ? " --tts" : "";
   const voiceFlag = tts && voice ? ` --voice ${voice}` : "";
+  const speedFlag = tts && speed && speed !== 1.0 ? ` --speed ${speed}` : "";
   const notifyFlag = notify ? " --notify" : "";
-  return `npx klaudio play "${normalized}"${ttsFlag}${voiceFlag}${notifyFlag}`;
+  // Resolve the CLI path at install time to avoid npx overhead on every hook call.
+  // When klaudio is updated and re-installed, hooks are rewritten with the new path.
+  const cliPath = new URL("../bin/cli.js", import.meta.url).pathname;
+  return `node "${cliPath}" play "${normalized}"${ttsFlag}${voiceFlag}${speedFlag}${notifyFlag}`;
 }

package/src/tts.js

@@ -133,11 +133,12 @@ async function getKokoro() {
  * Speak text using Kokoro TTS.
  * Returns true if successful, false if Kokoro is unavailable.
  */
-async function speakKokoro(text, voice) {
+async function speakKokoro(text, voice, speed) {
   const tts = await getKokoro();
   const voiceId = voice || KOKORO_DEFAULT_VOICE;
+  const voiceSpeed = speed || 1.0;
 
-  const audio = await tts.generate(text, { voice: voiceId, speed: 1.0 });
+  const audio = await tts.generate(text, { voice: voiceId, speed: voiceSpeed });
 
   // Save to temp wav and play
   const hash = createHash("md5").update(text + voiceId).digest("hex").slice(0, 8);
@@ -360,6 +361,7 @@ async function releaseTTSLock() {
  * @param {string} text - Text to speak
  * @param {object} [options]
  * @param {string} [options.voice] - Kokoro voice ID (e.g. "af_heart")
+ * @param {number} [options.speed] - Voice speed multiplier (default 1.0)
  * @param {Function} [options.onProgress] - Progress callback for downloads
  */
 export async function speak(text, options = {}) {
@@ -369,14 +371,14 @@ export async function speak(text, options = {}) {
   speaking = true;
 
   try {
-    const { voice, onProgress } = typeof options === "function"
-      ? { voice: null, onProgress: options }  // backwards compat: speak(text, onProgress)
+    const { voice, speed, onProgress } = typeof options === "function"
+      ? { voice: null, speed: null, onProgress: options }  // backwards compat: speak(text, onProgress)
       : options;
 
     // Try Kokoro (best quality)
     if (await isKokoroAvailable()) {
       try {
-        await speakKokoro(text, voice);
+        await speakKokoro(text, voice, speed);
         return;
       } catch {
         // Kokoro failed at runtime — fall through
@@ -394,4 +396,4 @@ export async function speak(text, options = {}) {
   }
 }
 
-export { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE };
+export { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE, ensureKokoroInstalled };