klaudio 0.8.0 → 0.8.3

package/README.md

@@ -11,9 +11,10 @@ npx klaudio
 The interactive installer walks you through:
 
 1. **Choose scope** — install globally (`~/.claude`) or per-project (`.claude/`), or launch the **Music Player**
-2. **Pick a source** — use a built-in preset, scan your Steam & Epic Games library for sounds, or provide custom files
+2. **Pick a source** — use a built-in preset, OS system sounds, scan your Steam & Epic Games library, 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`
+4. **Toggle voice summary** — enable TTS to hear a spoken summary when tasks complete
+5. **Install** — writes Claude Code hooks to your `settings.json`
 
 ## Sound Sources
 
@@ -21,6 +22,10 @@ The interactive installer walks you through:
 
 Ready-made sound packs (Retro 8-bit, Minimal Zen, Sci-Fi Terminal, Victory Fanfare) that work out of the box.
 
+### System Sounds
+
+Use your OS built-in notification sounds (Windows Media, macOS system sounds, Linux sound themes).
+
 ### Game Sound Scanner
 
 Scans your local Steam and Epic Games libraries for audio files:
@@ -47,15 +52,25 @@ Play longer game tracks (90s–4min) as background music while you code:
 
 Requires previously extracted game audio (use "Scan local games" first).
 
+## Voice Summary (TTS)
+
+When enabled, klaudio speaks a short summary of what Claude did after playing the task-complete sound. Uses [Piper](https://github.com/rhasspy/piper) for fast, offline neural text-to-speech (auto-downloaded on first use, ~40MB total).
+
+- Toggle with `t` on the scope or confirm screen
+- Reads the first sentence of Claude's last message
+- Uses the `en_GB-alan-medium` voice (British male)
+- Hooks receive data via stdin from Claude Code — no extra setup needed
+
 ## 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
+- **Duration filter** — type `<10s`, `>5s`, `<=3s` etc. to filter by audio length
 - **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
-- **Pre-loads existing config** — re-running the installer shows your current sound selections
+- **Re-apply current sounds** — re-running the installer shows your current selections with a quick re-apply option
 
 ## Events
 
@@ -74,7 +89,8 @@ npx klaudio --uninstall
 
 - Node.js 18+ (Claude Code already requires this)
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
-- For packed audio extraction: internet connection (vgmstream-cli is downloaded automatically)
+- For packed audio extraction: internet connection (vgmstream-cli downloaded automatically)
+- For voice summaries: internet connection on first use (Piper TTS downloaded automatically)
 - For best playback with fade effects: [ffmpeg/ffplay](https://ffmpeg.org/) on PATH (falls back to native players)
 
 > **Note:** Currently only tested on Windows. macOS and Linux support is planned but not yet verified.

package/package.json

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

package/src/cli.js

@@ -169,8 +169,13 @@ const ScopeScreen = ({ onNext, onMusic, tts, onToggleTts }) => {
 };
 
 // ── Screen: Preset ──────────────────────────────────────────────
-const PresetScreen = ({ onNext, onBack }) => {
+const PresetScreen = ({ existingSounds, onNext, onReapply, onBack }) => {
+  const hasExisting = existingSounds && Object.values(existingSounds).some(Boolean);
   const items = [
+    ...(hasExisting ? [{
+      label: "✓ Re-apply current sounds  — update config with current selections",
+      value: "_reapply",
+    }] : []),
     ...Object.entries(PRESETS).map(([id, p]) => ({
       label: `${p.icon} ${p.name}  — ${p.description}`,
       value: id,
@@ -180,18 +185,29 @@ const PresetScreen = ({ onNext, onBack }) => {
     { label: "🕹️  Scan your games library  — find sounds from Steam & Epic Games", value: "_scan" },
     { label: "📁 Custom files  — provide your own sound files", value: "_custom" },
   ];
-  const GAP_AT = Object.keys(PRESETS).length; // separator before non-preset options
+  const GAP_AT = (hasExisting ? 1 : 0) + Object.keys(PRESETS).length; // separator before non-preset options
   const [sel, setSel] = useState(0);
 
   useInput((input, key) => {
     if (key.escape) onBack();
     else if (input === "k" || key.upArrow) setSel((i) => Math.max(0, i - 1));
     else if (input === "j" || key.downArrow) setSel((i) => Math.min(items.length - 1, i + 1));
-    else if (key.return) onNext(items[sel].value);
+    else if (key.return) {
+      if (items[sel].value === "_reapply") onReapply();
+      else onNext(items[sel].value);
+    }
   });
 
   return h(Box, { flexDirection: "column" },
     h(Text, { bold: true }, "  Choose a sound preset:"),
+    hasExisting
+      ? h(Box, { flexDirection: "column", marginLeft: 4, marginBottom: 1 },
+          h(Text, { dimColor: true }, "Current sounds:"),
+          ...Object.entries(existingSounds).filter(([_, p]) => p).map(([eid, p]) =>
+            h(Text, { key: eid, color: "green", dimColor: true }, `  ✓ ${EVENTS[eid].name}: ${basename(p)}`),
+          ),
+        )
+      : null,
     h(Box, { flexDirection: "column", marginLeft: 2 },
       ...items.map((item, i) => h(React.Fragment, { key: item.value },
         i === GAP_AT ? h(Text, { dimColor: true }, "\n  ...or pick your own") : null,
@@ -1480,6 +1496,8 @@ const InstallApp = () => {
 
       case SCREEN.PRESET:
         return h(PresetScreen, {
+          existingSounds: sounds,
+          onReapply: () => setScreen(SCREEN.CONFIRM),
           onNext: (id) => {
             if (id === "_music") {
               setScreen(SCREEN.MUSIC_MODE);

package/src/player.js

@@ -392,13 +392,28 @@ export async function handlePlayCommand(args) {
 
   // TTS: speak first 1-2 sentences of last_assistant_message
   if (tts && hookData.last_assistant_message) {
-    const msg = hookData.last_assistant_message;
-    // Extract first sentence only
+    // Strip markdown syntax and extract first sentence
+    const msg = hookData.last_assistant_message
+      .replace(/```[\s\S]*?```/g, "")      // remove code blocks
+      .replace(/`([^`]+)`/g, "$1")          // inline code -> text
+      .replace(/\*\*([^*]+)\*\*/g, "$1")    // **bold** -> text
+      .replace(/\*([^*]+)\*/g, "$1")        // *italic* -> text
+      .replace(/__([^_]+)__/g, "$1")        // __bold__ -> text
+      .replace(/_([^_]+)_/g, "$1")          // _italic_ -> text
+      .replace(/#{1,6}\s+/g, "")            // headings
+      .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // [links](url) -> text
+      .replace(/^\s*[-*+]\s+/gm, "")        // list bullets
+      .replace(/^\s*\d+\.\s+/gm, "")        // numbered lists
+      .replace(/\n+/g, " ")                 // newlines -> spaces
+      .trim();
     const sentences = msg.match(/[^.!?]*[.!?]/g);
     const summary = sentences ? sentences[0].trim() : msg.slice(0, 100);
+    // Prefix with project folder name if available
+    const project = hookData.cwd ? hookData.cwd.replace(/\\/g, "/").split("/").pop() : null;
+    const spoken = project ? `${project}: ${summary}` : summary;
     await soundPromise;
     const { speak } = await import("./tts.js");
-    await speak(summary);
+    await speak(spoken);
   } else {
     await soundPromise;
   }

package/src/tts.js

@@ -179,13 +179,27 @@ export async function ensureVoiceModel(onProgress) {
 }
 
 /**
- * Speak text using Piper TTS.
+ * Speak text using macOS `say` command (built-in, good quality).
+ */
+function speakMacOS(text) {
+  return new Promise((resolve) => {
+    execFile("say", ["-v", "Daniel", text], { timeout: 15000 }, () => resolve());
+  });
+}
+
+/**
+ * Speak text using Piper TTS, with macOS `say` fallback.
  * Auto-downloads piper and voice model on first use.
  * Returns a promise that resolves when speech is done.
  */
 export async function speak(text, onProgress) {
   if (!text) return;
 
+  // macOS: use built-in `say` — better compatibility, no dylib issues
+  if (platform() === "darwin") {
+    return speakMacOS(text);
+  }
+
   let piperBin, modelPath;
   try {
     [piperBin, modelPath] = await Promise.all([
@@ -201,20 +215,24 @@ export async function speak(text, onProgress) {
   const hash = createHash("md5").update(text).digest("hex").slice(0, 8);
   const outPath = join(tmpdir(), `klaudio-tts-${hash}.wav`);
 
-  await new Promise((resolve, reject) => {
-    const child = execFile(piperBin, [
-      "--model", modelPath,
-      "--output_file", outPath,
-    ], { windowsHide: true, timeout: 15000 }, (err) => {
-      if (err) reject(err);
-      else resolve();
+  try {
+    await new Promise((resolve, reject) => {
+      const child = execFile(piperBin, [
+        "--model", modelPath,
+        "--output_file", outPath,
+      ], { windowsHide: true, timeout: 15000 }, (err) => {
+        if (err) reject(err);
+        else resolve();
+      });
+      // Feed text via stdin
+      child.stdin.write(text);
+      child.stdin.end();
     });
-    // Feed text via stdin
-    child.stdin.write(text);
-    child.stdin.end();
-  });
 
-  // Play the generated wav
-  const { playSoundWithCancel } = await import("./player.js");
-  await playSoundWithCancel(outPath, { maxSeconds: 0 }).promise.catch(() => {});
+    // Play the generated wav
+    const { playSoundWithCancel } = await import("./player.js");
+    await playSoundWithCancel(outPath, { maxSeconds: 0 }).promise.catch(() => {});
+  } catch {
+    // Piper failed (dylib error, etc.) — skip silently
+  }
 }