klaudio 0.10.0 → 0.10.2

package/bin/cli.js

@@ -1,12 +1,25 @@
 #!/usr/bin/env node
 
-// Subcommand: klaudio play <file> [--tts]
+// Subcommand: klaudio play <file> [--tts] [--voice <voice>]
 if (process.argv[2] === "play") {
   const { handlePlayCommand } = await import("../src/player.js");
   await handlePlayCommand(process.argv.slice(3));
   process.exit(0);
 }
 
+// Subcommand: klaudio say "text" [--voice <voice>]
+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];
+  if (text) {
+    const { speak } = await import("../src/tts.js");
+    await speak(text, { voice });
+  }
+  process.exit(0);
+}
+
 // Default: interactive installer UI
 const { run } = await import("../src/cli.js");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klaudio",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "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 } from "./tts.js";
+import { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE } from "./tts.js";
 import { playSoundWithCancel, getWavDuration } from "./player.js";
 import { getAvailableGames, getSystemSounds } from "./scanner.js";
 import { install, uninstall, getExistingSounds } from "./installer.js";
@@ -1370,10 +1370,11 @@ const ExtractingScreen = ({ game, onDone, onBack }) => {
 };
 
 // ── Screen: Confirm ─────────────────────────────────────────────
-const ConfirmScreen = ({ scope, sounds, tts, onToggleTts, onConfirm, onBack }) => {
+const ConfirmScreen = ({ scope, sounds, tts, voice, onToggleTts, onCycleVoice, onConfirm, onBack }) => {
   useInput((input, key) => {
     if (key.escape) onBack();
     else if (input === "t") onToggleTts();
+    else if (input === "v" && tts) onCycleVoice();
   });
 
   const items = [
@@ -1382,6 +1383,7 @@ const ConfirmScreen = ({ scope, sounds, tts, onToggleTts, onConfirm, onBack }) =
   ];
 
   const soundEntries = Object.entries(sounds).filter(([_, path]) => path);
+  const voiceInfo = KOKORO_VOICES.find((v) => v.id === voice);
 
   return h(Box, { flexDirection: "column" },
     h(Text, { bold: true, marginLeft: 2 }, "  Ready to install:"),
@@ -1398,6 +1400,12 @@ const ConfirmScreen = ({ scope, sounds, tts, onToggleTts, onConfirm, onBack }) =
         ),
         h(Text, { dimColor: true }, "  (t to toggle — reads a short summary when tasks complete)"),
       ),
+      tts && voiceInfo ? h(Box, { marginLeft: 4 },
+        h(Text, { color: ACCENT },
+          `🎙 Voice: ${voiceInfo.name} (${voiceInfo.gender}, ${voiceInfo.accent})`,
+        ),
+        h(Text, { dimColor: true }, "  (v to change voice)"),
+      ) : null,
     ),
     h(Box, { marginTop: 1, marginLeft: 2 },
       h(SelectInput, { indicatorComponent: Indicator, itemComponent: Item, items, onSelect: (item) => {
@@ -1521,6 +1529,7 @@ const InstallApp = () => {
   const [selectedGame, setSelectedGame] = useState(null);
   const [installResult, setInstallResult] = useState(null);
   const [tts, setTts] = useState(true);
+  const [voice, setVoice] = useState(KOKORO_DEFAULT_VOICE);
   const [musicFiles, setMusicFiles] = useState([]);
   const [musicGameName, setMusicGameName] = useState(null);
   const [musicShuffle, setMusicShuffle] = useState(false);
@@ -1569,6 +1578,7 @@ const InstallApp = () => {
             } else {
               setPresetId(id);
               initSoundsFromPreset(id);
+              if (KOKORO_PRESET_VOICES[id]) setVoice(KOKORO_PRESET_VOICES[id]);
               setScreen(SCREEN.PREVIEW);
             }
           },
@@ -1649,7 +1659,12 @@ const InstallApp = () => {
           scope,
           sounds,
           tts,
+          voice,
           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;
+          }),
           onConfirm: () => setScreen(SCREEN.INSTALLING),
           onBack: () => {
             if (selectedGame) setScreen(SCREEN.GAME_SOUNDS);
@@ -1662,7 +1677,7 @@ const InstallApp = () => {
           scope,
           sounds,
           tts,
-          voice: KOKORO_PRESET_VOICES[presetId],
+          voice,
           onDone: (result) => {
             setInstallResult(result);
             setScreen(SCREEN.DONE);

package/src/installer.js

@@ -118,7 +118,7 @@ async function installApprovalHooks(settings, soundPath, claudeDir) {
   // Write the timer script
   const script = `#!/usr/bin/env bash
 # klaudio: approval notification timer
-# Plays a sound if a tool isn't approved within DELAY seconds.
+# Plays a sound + speaks a TTS message if a tool isn't approved within DELAY seconds.
 DELAY=15
 MARKER="/tmp/.claude-approval-pending"
 SOUND="${normalized}"
@@ -126,12 +126,16 @@ SOUND="${normalized}"
 case "$1" in
   start)
     TOKEN="$$-$(date +%s%N)"
+    # Store token and CWD so the delayed notification knows the project name
     echo "$TOKEN" > "$MARKER"
+    echo "$PWD" >> "$MARKER"
     (
       sleep "$DELAY"
-      if [ -f "$MARKER" ] && [ "$(cat "$MARKER" 2>/dev/null)" = "$TOKEN" ]; then
+      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 say "\${PROJECT:-project} needs your attention" 2>/dev/null
       fi
     ) &
     ;;

package/src/tts.js

@@ -21,6 +21,22 @@ const KOKORO_PRESET_VOICES = {
 };
 const KOKORO_DEFAULT_VOICE = "af_heart";
 
+// Curated voice list for the picker (best quality voices)
+const KOKORO_VOICES = [
+  { id: "af_heart",  name: "Heart",  gender: "F", accent: "US", grade: "A" },
+  { id: "af_bella",  name: "Bella",  gender: "F", accent: "US", grade: "A-" },
+  { id: "af_nicole", name: "Nicole", gender: "F", accent: "US", grade: "B-" },
+  { id: "af_nova",   name: "Nova",   gender: "F", accent: "US", grade: "C" },
+  { id: "af_sky",    name: "Sky",    gender: "F", accent: "US", grade: "C-" },
+  { id: "af_sarah",  name: "Sarah",  gender: "F", accent: "US", grade: "C+" },
+  { id: "am_fenrir", name: "Fenrir", gender: "M", accent: "US", grade: "C+" },
+  { id: "am_michael",name: "Michael",gender: "M", accent: "US", grade: "C+" },
+  { id: "am_puck",   name: "Puck",   gender: "M", accent: "US", grade: "C+" },
+  { id: "bf_emma",   name: "Emma",   gender: "F", accent: "UK", grade: "B-" },
+  { id: "bm_george", name: "George", gender: "M", accent: "UK", grade: "C" },
+  { id: "bm_fable",  name: "Fable",  gender: "M", accent: "UK", grade: "C" },
+];
+
 // Singleton: reuse the loaded model across calls
 let kokoroInstance = null;
 let kokoroLoadPromise = null;
@@ -244,9 +260,33 @@ function speakMacOS(text) {
 
 // ── Public API ──────────────────────────────────────────────────
 
+let speaking = false;
+const TTS_LOCK = join(tmpdir(), ".klaudio-tts-lock");
+
+/**
+ * Try to acquire a cross-process TTS lock.
+ * Returns true if acquired, false if another process is speaking.
+ * Stale locks (>30s) are automatically cleaned up.
+ */
+async function acquireTTSLock() {
+  try {
+    const lockStat = await stat(TTS_LOCK);
+    if (Date.now() - lockStat.mtimeMs < 30000) return false; // fresh lock, skip
+  } catch { /* no lock file, good */ }
+  try {
+    await fsWriteFile(TTS_LOCK, String(process.pid), "utf-8");
+    return true;
+  } catch { return false; }
+}
+
+async function releaseTTSLock() {
+  try { const { unlink } = await import("node:fs/promises"); await unlink(TTS_LOCK); } catch { /* ignore */ }
+}
+
 /**
  * Speak text using the best available TTS engine.
  * Priority: Kokoro (GPU/CPU) → Piper → macOS say
+ * Only one speak() call runs at a time — concurrent calls are skipped.
  *
  * @param {string} text - Text to speak
  * @param {object} [options]
@@ -255,26 +295,34 @@ function speakMacOS(text) {
  */
 export async function speak(text, options = {}) {
   if (!text) return;
+  if (speaking) return; // in-process mutex
+  if (!await acquireTTSLock()) return; // cross-process mutex
+  speaking = true;
 
-  const { voice, onProgress } = typeof options === "function"
-    ? { voice: null, onProgress: options }  // backwards compat: speak(text, onProgress)
-    : options;
-
-  // Try Kokoro first (works on all platforms, best quality)
   try {
-    await speakKokoro(text, voice);
-    return;
-  } catch {
-    // Kokoro unavailable — fall through
-  }
+    const { voice, onProgress } = typeof options === "function"
+      ? { voice: null, onProgress: options }  // backwards compat: speak(text, onProgress)
+      : options;
+
+    // Try Kokoro first (works on all platforms, best quality)
+    try {
+      await speakKokoro(text, voice);
+      return;
+    } catch {
+      // Kokoro unavailable — fall through
+    }
 
-  // macOS: use built-in `say`
-  if (platform() === "darwin") {
-    return speakMacOS(text);
-  }
+    // macOS: use built-in `say`
+    if (platform() === "darwin") {
+      return speakMacOS(text);
+    }
 
-  // Fallback: Piper
-  return speakPiper(text, onProgress);
+    // Fallback: Piper
+    return speakPiper(text, onProgress);
+  } finally {
+    speaking = false;
+    await releaseTTSLock();
+  }
 }
 
-export { KOKORO_PRESET_VOICES };
+export { KOKORO_PRESET_VOICES, KOKORO_VOICES, KOKORO_DEFAULT_VOICE };