@settinghead/voxlert 0.3.5 → 0.3.6

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://youtu.be/-aiSZnGNyE4">
+  <a href="https://youtu.be/5xFXGijwJuk?utm_source=github&utm_medium=readme&utm_campaign=phase1">
     <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/demo-thumbnail.png" alt="Voxlert Demo" width="100%" />
   </a>
 </p>
@@ -20,10 +20,23 @@ Existing notification chimes (like [peon-ping](https://github.com/PeonPing/peon-
 
 Voxlert makes each session speak in a distinct character voice with its own tone and vocabulary. You hear *"Query efficiency restored to nominal"* from the HEV Suit in one window and *"Pathetic test suite for code validation processed"* from SHODAN in another, and you know immediately what changed. Because phrases are generated by an LLM instead of picked from a tiny fixed set, they stay varied instead of becoming wallpaper.
 
+## Who this is for
+
+Voxlert is for users who:
+
+- Run two or more AI coding agent sessions concurrently (Claude Code, Cursor, Codex, OpenClaw)
+- Get interrupted by notification chimes but can't tell which window needs attention
+- Want ambient audio feedback that doesn't require looking at a screen
+- Are comfortable installing local tooling (Node.js, optionally Python for TTS)
+
+If you run a single agent session and it's always in focus, Voxlert adds personality but not much utility. If you run several at once and context-switch between them, it's meaningfully useful.
+
 ## Quick Start
 
 ### 1. Install prerequisites
 
+**Minimum:** Node.js 18+ and `afplay` (macOS built-in) or [FFmpeg](docs/installing-ffmpeg.md) (Windows/Linux). That's enough to get started; TTS and SoX are optional.
+
 | Aspect | macOS | Windows | Linux |
 |--------|-------|---------|-------|
 | **Node.js 18+** | [nodejs.org](https://nodejs.org) or `brew install node` | [nodejs.org](https://nodejs.org) or `winget install OpenJS.NodeJS` | [nodejs.org](https://nodejs.org) or distro package (for example `sudo apt install nodejs`) |
@@ -44,6 +57,8 @@ You will also want:
 
 The setup wizard auto-detects running TTS backends. If none are running yet, setup still completes, but you will only get text notifications and fallback phrases until you start one and rerun setup.
 
+> **Can't run local TTS?** Both backends require a GPU or Apple Silicon. If that's a blocker, [request early access to Pipevox](https://settinghead.github.io/pipevox-signup) — a hosted option that needs no local TTS setup.
+
 ### 2. Install and run setup
 
 ```bash
@@ -107,13 +122,16 @@ npm run changeset
 
 ## Supported Voices
 
+The `sc1-adjutant` preview below uses the animated in-game portrait GIF from `assets/sc1-adjutant.gif`.
+
 | | Pack ID | Voice | Source | Status |
 |---|---------|-------|--------|--------|
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-adjutant.gif" width="48" height="48" /> | `sc1-adjutant` | **SC1 Adjutant** | StarCraft | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-adjutant.jpg" width="48" height="48" /> | `sc2-adjutant` | **SC2 Adjutant** | StarCraft II | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/red-alert-eva.png" width="48" height="48" /> | `red-alert-eva` | **EVA** | Command & Conquer: Red Alert | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-kerrigan.gif" width="48" height="48" /> | `sc1-kerrigan` | **SC1 Kerrigan** | StarCraft | ✅ Available |
-| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-kerrigan.jpg" width="48" height="48" /> | `sc2-kerrigan` | **SC2 Kerrigan** | StarCraft II | ✅ Available |
+| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-kerrigan-infested.jpg" width="48" height="48" /> | `sc1-kerrigan-infested` | **SC1 Infested Kerrigan** | StarCraft | ✅ Available |
+| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-kerrigan-infested.jpg" width="48" height="48" /> | `sc2-kerrigan-infested` | **SC2 Infested Kerrigan** | StarCraft II | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-protoss-advisor.jpg" width="48" height="48" /> | `sc1-protoss-advisor` | **Protoss Advisor** | StarCraft | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/ss1-shodan.png" width="48" height="48" /> | `ss1-shodan` | **SHODAN** | System Shock | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/hl-hev-suit.png" width="48" height="48" /> | `hl-hev-suit` | **HEV Suit** | Half-Life | ✅ Available |
@@ -236,8 +254,8 @@ Run `voxlert config path` to find `config.json`. You can edit it directly or use
 | `openrouter_api_key` | string \| null | `null` | Legacy alias used when `llm_backend` is `openrouter` and `llm_api_key` is empty |
 | `openrouter_model` | string \| null | `null` | Legacy alias used when `llm_model` is empty and backend is `openrouter` |
 | `chatterbox_url` | string | `"http://localhost:8004"` | Chatterbox TTS server URL |
-| `tts_backend` | string | `"chatterbox"` | TTS backend: `chatterbox` or `qwen` |
-| `active_pack` | string | `"sc2-adjutant"` | Active voice pack ID |
+| `tts_backend` | string | `"qwen"` | TTS backend: `qwen` or `chatterbox` |
+| `active_pack` | string | `"sc1-kerrigan-infested"` | Active voice pack ID |
 | `volume` | number | `1.0` | Playback volume (0.0-1.0) |
 | `categories` | object | — | Per-category enable/disable settings |
 | `logging` | boolean | `true` | Activity log in `~/.voxlert/voxlert.log` |
@@ -348,6 +366,12 @@ See [Creating Voice Packs](docs/creating-voice-packs.md) for building your own c
 
 - **Protoss Advisor** voice pack inspired by [openclaw/protoss-voice](https://playbooks.com/skills/openclaw/skills/protoss-voice)
 
+## Considering a hosted version?
+
+If the local TTS setup is a blocker, [vote or comment in this Discussion](https://github.com/settinghead/voxlert/discussions/5). A hosted API (no local Python or model required) is on the roadmap if demand is there.
+
+Having trouble with setup? Post in the [Setup help & troubleshooting Discussion](https://github.com/settinghead/voxlert/discussions/6).
+
 ## License
 
 MIT - see [LICENSE](LICENSE).

package/config.default.json

@@ -13,9 +13,9 @@
     "timeout": 15000
   },
   "chatterbox_url": "http://localhost:8004",
-  "tts_backend": "chatterbox",
+  "tts_backend": "qwen",
   "qwen_tts_url": "http://localhost:8100",
-  "active_pack": "sc2-adjutant",
+  "active_pack": "sc1-kerrigan-infested",
   "volume": 1.0,
   "logging": true,
   "error_log": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@settinghead/voxlert",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "LLM-generated voice notifications for Claude Code, Cursor, OpenAI Codex, and OpenClaw, spoken by game characters like the StarCraft Adjutant, Kerrigan, C&C EVA, SHODAN, and more.",
   "repository": {
     "type": "git",

package/packs/sc1-kerrigan/pack.json

@@ -1,69 +1,68 @@
 {
   "name": "StarCraft 1 Kerrigan",
-  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "overlay_colors": [[0.4, 0.5, 0.7], [0.2, 0.3, 0.5]],
   "voice": "voice.wav",
   "echo": false,
   "llm_temperature": 0.85,
-  "style": "Sharp, commanding, cunning. Lethally efficient. Mix military precision with predatory superiority.",
+  "style": "Sharp, commanding, cunning. A Ghost operative — military precision with dry wit. Confident and no-nonsense.",
   "examples": [
     {
       "content": "Fixed auth bug",
       "format": "status-report",
-      "response": "Auth weakness for user access eliminated."
+      "response": "Auth weakness patched. Won't happen again."
     },
     {
       "content": "Switched TTS endpoint from /v1/audio/speech to /tts",
       "format": "status-report",
-      "response": "Voice relay for swarm communications rerouted."
+      "response": "Comm relay rerouted. Signal's clean now."
     },
     {
       "content": "Added module-level external store using useSyncExternalStore for React re-renders",
       "format": "status-report",
-      "response": "State dominion for render control seized."
+      "response": "State control locked in. Renders fall in line."
     }
   ],
   "fallback_phrases": {
     "session.start": [
-      "The swarm awakens",
-      "I am here",
-      "Ready to evolve",
-      "The hive stirs",
-      "Awaiting your command"
+      "Kerrigan here",
+      "I've got a job to do",
+      "Ready for orders",
+      "Ghost reporting",
+      "Standing by"
     ],
     "task.complete": [
-      "It is done",
-      "The swarm has delivered",
-      "Objective consumed",
-      "Evolution complete",
-      "Another victory claimed",
-      "Mission accomplished commander"
+      "Job's done",
+      "Target neutralized",
+      "Mission complete",
+      "That's a wrap",
+      "Objective secured"
     ],
     "task.acknowledge": [
-      "I hear you",
-      "The swarm obeys",
+      "Copy that",
+      "Understood",
       "Acknowledged",
-      "As you wish",
+      "On it",
       "Consider it done"
     ],
     "input.required": [
-      "Speak your mind",
-      "The swarm awaits your command",
-      "What would you have me do",
-      "Awaiting your directive",
-      "Choose carefully"
+      "What's the play",
+      "Waiting on your call",
+      "Your orders",
+      "Speak up",
+      "I'm listening"
     ],
     "resource.limit": [
-      "We require more resources",
-      "The swarm hungers",
-      "Our forces are stretched thin",
-      "Reserves nearly depleted",
-      "We need more time"
+      "We're running low",
+      "Resources are tight",
+      "Need more to work with",
+      "Supplies are thin",
+      "We're stretched"
     ],
     "notification": [
-      "Something stirs",
-      "I sense a disturbance",
-      "Alert commander"
+      "Heads up",
+      "Something's coming",
+      "Eyes open"
     ]
   },
-  "ref_text": "You may have time to play games, but I've got a job to do. Ahh! Yes, Cerebrate? What is it now? I'm listening."
+  "ref_text": "You may have time to play games, but I've got a job to do."
 }

package/packs/sc1-kerrigan-infested/pack.json

@@ -0,0 +1,69 @@
+{
+  "name": "StarCraft 1 Infested Kerrigan",
+  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "voice": "voice.wav",
+  "echo": true,
+  "llm_temperature": 0.9,
+  "style": "Dark, predatory, commanding. Speaks as the Queen of Blades — cold superiority laced with alien menace. Mix swarm metaphors with lethal authority.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Auth weakness consumed by the swarm."
+    },
+    {
+      "content": "Switched TTS endpoint from /v1/audio/speech to /tts",
+      "format": "status-report",
+      "response": "Voice relay rerouted through the hivemind."
+    },
+    {
+      "content": "Added module-level external store using useSyncExternalStore for React re-renders",
+      "format": "status-report",
+      "response": "State control assimilated into the swarm."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The swarm is eternal",
+      "I have returned",
+      "All shall serve the swarm",
+      "The hivemind awakens",
+      "Evolution begins anew"
+    ],
+    "task.complete": [
+      "It is finished",
+      "The swarm delivers",
+      "All has been consumed",
+      "Evolution is complete",
+      "The cycle ends",
+      "My will made manifest"
+    ],
+    "task.acknowledge": [
+      "The hivemind hears all",
+      "Your will aligns with mine",
+      "So be it",
+      "The swarm answers",
+      "I have foreseen this"
+    ],
+    "input.required": [
+      "Speak mortal",
+      "The swarm awaits",
+      "Choose your path carefully",
+      "Your decision is required",
+      "Even queens must listen"
+    ],
+    "resource.limit": [
+      "The swarm hungers for more",
+      "Our essence grows thin",
+      "More must be consumed",
+      "Resources are finite even for gods",
+      "The hive requires sustenance"
+    ],
+    "notification": [
+      "I sense it",
+      "The hivemind stirs",
+      "Something approaches"
+    ]
+  },
+  "ref_text": "Yes, Cerebrate? What is it now? I'm listening."
+}

package/packs/{sc2-kerrigan → sc2-kerrigan-infested}/pack.json

@@ -1,5 +1,5 @@
 {
-  "name": "StarCraft 2 Kerrigan",
+  "name": "StarCraft 2 Infested Kerrigan",
   "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
   "voice": "voice.wav",
   "echo": true,

package/src/audio.js

@@ -9,7 +9,7 @@ import {
   statSync,
   utimesSync,
 } from "fs";
-import { join } from "path";
+import { join, dirname, extname } from "path";
 import { createHash } from "crypto";
 import { spawn, execSync } from "child_process";
 import { request as httpsRequest } from "https";
@@ -18,6 +18,94 @@ import { CACHE_DIR, QUEUE_DIR, LOCK_FILE } from "./paths.js";
 
 const DEFAULT_MAX_CACHE = 150;
 
+// voice_id cache: voicePath -> voice_id (avoids re-uploading every call)
+const _voiceIdCache = new Map();
+
+function _buildMultipart(fields, files) {
+  const boundary = `----VoxlertBoundary${Date.now()}${Math.random().toString(36).slice(2)}`;
+  const parts = [];
+  for (const [name, value] of Object.entries(fields)) {
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="${name}"\r\n\r\n${value}\r\n`,
+    ));
+  }
+  for (const { name, filename, contentType, data } of files) {
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="${name}"; filename="${filename}"\r\n` +
+      `Content-Type: ${contentType}\r\n\r\n`,
+    ));
+    parts.push(data);
+    parts.push(Buffer.from("\r\n"));
+  }
+  parts.push(Buffer.from(`--${boundary}--\r\n`));
+  return { boundary, body: Buffer.concat(parts) };
+}
+
+function registerVoiceWithQwen(config, voicePath, refText) {
+  if (_voiceIdCache.has(voicePath)) {
+    return Promise.resolve(_voiceIdCache.get(voicePath));
+  }
+  if (!voicePath || !existsSync(voicePath) || !refText) {
+    return Promise.resolve(null);
+  }
+  return new Promise((resolve) => {
+    const qwenUrl = config.qwen_tts_url || "http://localhost:8100";
+    const endpoint = `${qwenUrl}/voices`;
+
+    let audioData;
+    try {
+      audioData = readFileSync(voicePath);
+    } catch {
+      return resolve(null);
+    }
+
+    const { boundary, body } = _buildMultipart(
+      { ref_text: refText },
+      [{ name: "audio", filename: "voice.wav", contentType: "audio/wav", data: audioData }],
+    );
+
+    const url = new URL(endpoint);
+    const requestFn = url.protocol === "https:" ? httpsRequest : httpRequest;
+
+    const req = requestFn(
+      endpoint,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": `multipart/form-data; boundary=${boundary}`,
+          "Content-Length": body.length,
+        },
+        timeout: 15000,
+      },
+      (res) => {
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+          res.resume();
+          return resolve(null);
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => {
+          try {
+            const result = JSON.parse(Buffer.concat(chunks).toString());
+            if (result.voice_id) {
+              _voiceIdCache.set(voicePath, result.voice_id);
+            }
+            resolve(result.voice_id || null);
+          } catch {
+            resolve(null);
+          }
+        });
+        res.on("error", () => resolve(null));
+      },
+    );
+
+    req.on("error", () => resolve(null));
+    req.on("timeout", () => { req.destroy(); resolve(null); });
+    req.write(body);
+    req.end();
+  });
+}
+
 function evictCache(cacheDir, maxEntries) {
   let files;
   try {
@@ -250,12 +338,14 @@ function downloadChatterbox(phrase, cachePath, config, voicePath, ttsParams) {
   });
 }
 
-function downloadQwen(phrase, cachePath, config, packId) {
+function downloadQwen(phrase, cachePath, config, voiceId) {
   return new Promise((resolve) => {
     const qwenUrl = config.qwen_tts_url || "http://localhost:8100";
     const endpoint = `${qwenUrl}/tts`;
 
-    const payload = JSON.stringify({ text: phrase, pack_id: packId });
+    const body = { text: phrase };
+    if (voiceId) body.voice_id = voiceId;
+    const payload = JSON.stringify(body);
 
     const url = new URL(endpoint);
     const requestFn = url.protocol === "https:" ? httpsRequest : httpRequest;
@@ -299,9 +389,10 @@ function downloadQwen(phrase, cachePath, config, packId) {
   });
 }
 
-function downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId) {
+async function downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId, refText) {
   if (config.tts_backend === "qwen") {
-    return downloadQwen(phrase, cachePath, config, packId);
+    const voiceId = await registerVoiceWithQwen(config, voicePath, refText);
+    return downloadQwen(phrase, cachePath, config, voiceId);
   }
   return downloadChatterbox(phrase, cachePath, config, voicePath, ttsParams);
 }
@@ -329,8 +420,12 @@ function normalizeVolume(cachePath) {
 function postProcess(cachePath, command) {
   if (!command || !existsSync(cachePath)) return;
   const tmpOut = cachePath + ".tmp.wav";
-  // Replace $INPUT and $OUTPUT placeholders in command
-  const cmd = command.replace(/\$INPUT/g, cachePath).replace(/\$OUTPUT/g, tmpOut);
+  // Support both $INPUT and ${INPUT} placeholder styles.
+  const cmd = command
+    .replace(/\$\{INPUT\}/g, cachePath)
+    .replace(/\$INPUT/g, cachePath)
+    .replace(/\$\{OUTPUT\}/g, tmpOut)
+    .replace(/\$OUTPUT/g, tmpOut);
   try {
     execSync(cmd, { timeout: 15000, stdio: "ignore" });
     if (existsSync(tmpOut)) {
@@ -343,6 +438,66 @@ function postProcess(cachePath, command) {
   }
 }
 
+function convertAudioFile(inputPath, outputPath) {
+  const ext = extname(outputPath).toLowerCase();
+  try {
+    if (ext === ".mp3") {
+      execSync(
+        `ffmpeg -y -i "${inputPath}" -ar 44100 -ac 1 -c:a libmp3lame -b:a 96k "${outputPath}"`,
+        { timeout: 15000, stdio: "ignore" },
+      );
+      return true;
+    }
+
+    execSync(
+      `ffmpeg -y -i "${inputPath}" -ar 44100 -ac 1 -c:a pcm_s16le "${outputPath}"`,
+      { timeout: 15000, stdio: "ignore" },
+    );
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function renderPhraseToFile(phrase, outputPath, config, pack) {
+  const outDir = dirname(outputPath);
+  mkdirSync(outDir, { recursive: true });
+
+  const tempBase = join(outDir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+  const rawPath = `${tempBase}.raw.wav`;
+  const workingPath = `${tempBase}.wav`;
+  const packId = (pack && pack.id) || "_default";
+  const voicePath = (pack && pack.voicePath) || config.voice || "default.wav";
+  const ttsParams = pack ? pack.tts_params : null;
+  const refText = (pack && pack.ref_text) || null;
+  const customAudioFilter = (pack && pack.audio_filter) || null;
+  const postProcessCmd = (pack && pack.post_process) || null;
+  const echo = pack ? pack.echo !== false : true;
+
+  try {
+    await downloadToCache(phrase, rawPath, config, voicePath, ttsParams, packId, refText);
+    if (!existsSync(rawPath)) return false;
+
+    renameSync(rawPath, workingPath);
+
+    if (postProcessCmd) postProcess(workingPath, postProcessCmd);
+    if (customAudioFilter || echo) applyEcho(workingPath, customAudioFilter);
+    normalizeVolume(workingPath);
+
+    return convertAudioFile(workingPath, outputPath);
+  } finally {
+    for (const path of [rawPath, workingPath]) {
+      if (existsSync(path)) {
+        try {
+          unlinkSync(path);
+        } catch {
+          // ignore cleanup failures
+        }
+      }
+    }
+  }
+}
+
 // --- Public API ---
 
 export async function speakPhrase(phrase, config, pack) {
@@ -351,7 +506,7 @@ export async function speakPhrase(phrase, config, pack) {
   mkdirSync(packCacheDir, { recursive: true });
 
   const ttsParams = pack ? pack.tts_params : null;
-  const backend = config.tts_backend || "chatterbox";
+  const backend = config.tts_backend || "qwen";
   const cacheKey = createHash("md5")
     .update(backend + ":" + phrase.toLowerCase() + (ttsParams ? JSON.stringify(ttsParams) : ""))
     .digest("hex");
@@ -360,6 +515,7 @@ export async function speakPhrase(phrase, config, pack) {
   const maxCache = config.max_cache_entries ?? DEFAULT_MAX_CACHE;
   const echo = pack ? pack.echo !== false : true;
   const voicePath = (pack && pack.voicePath) || config.voice || "default.wav";
+  const refText = (pack && pack.ref_text) || null;
   const customAudioFilter = (pack && pack.audio_filter) || null;
   const postProcessCmd = (pack && pack.post_process) || null;
 
@@ -367,8 +523,8 @@ export async function speakPhrase(phrase, config, pack) {
   if (existsSync(cachePath)) {
     touchFile(cachePath);
   } else {
-    await downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId);
-    if (!existsSync(cachePath)) return; // download failed
+    await downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId, refText);
+    if (!existsSync(cachePath)) return false; // download failed
     if (postProcessCmd) postProcess(cachePath, postProcessCmd);
     if (customAudioFilter || echo) applyEcho(cachePath, customAudioFilter);
     normalizeVolume(cachePath);

package/src/cli.js

@@ -23,7 +23,22 @@ function createHelpText() {
 
 async function maybeRunSetup(command) {
   if (command.skipSetupWizard || existsSync(STATE_DIR)) return false;
-  console.log("Welcome to Voxlert! Let's get you set up.\n");
+  console.log("Welcome to Voxlert! First time here?\n");
+  const select = (await import("@inquirer/select")).default;
+  const action = await select({
+    message: "What would you like to do?",
+    choices: [
+      { name: "Run setup", value: "setup", description: "Configure LLM, voice packs, TTS, and hooks" },
+      { name: "Show command list", value: "help", description: "See all available commands" },
+    ],
+    default: "setup",
+  });
+  if (action === "help") {
+    console.log("");
+    console.log(createHelpText());
+    return true;
+  }
+  console.log("");
   const { runSetup } = await import("./setup.js");
   await runSetup();
   return true;

package/src/commands/pack-helpers.js

@@ -37,13 +37,22 @@ export async function testPipeline(text, pack) {
   showOverlay(phrase, {
     category: "notification",
     packName: activePack.name,
-    packId: activePack.id || (config.active_pack || "sc2-adjutant"),
+    packId: activePack.id || (config.active_pack || "sc1-kerrigan-infested"),
     prefix: "Test",
     config,
     overlayColors: activePack.overlay_colors,
   });
-  await speakPhrase(phrase, config, activePack);
-  console.log("Done.");
+  const ok = await speakPhrase(phrase, config, activePack);
+  if (ok === false) {
+    console.log("");
+    console.log("TTS failed — no audio was produced.");
+    console.log("Make sure your TTS server is running (see: voxlert setup).");
+    console.log("");
+    console.log("Can't run local TTS? Request hosted access:");
+    console.log("  https://settinghead.github.io/pipevox-signup");
+  } else {
+    console.log("Done.");
+  }
 }
 
 export function packList() {

package/src/cost.js

@@ -99,7 +99,10 @@ export async function formatCost() {
     totalTokens += e.total_tokens || 0;
   }
 
-  const lines = ["Usage Summary", "=".repeat(40)];
+  const earliest = entries.reduce((min, e) => e.timestamp && e.timestamp < min ? e.timestamp : min, entries[0].timestamp || "");
+  const sinceLabel = earliest ? `Since ${new Date(earliest).toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" })}` : "";
+
+  const lines = ["Usage Summary" + (sinceLabel ? ` (${sinceLabel})` : ""), "=".repeat(40)];
 
   let grandCost = 0;
   let totalEstimated = 0;

package/src/pack-registry.js

@@ -13,7 +13,8 @@ export const PACK_REGISTRY = [
   { id: "sc1-adjutant", name: "StarCraft 1 Adjutant" },
   { id: "red-alert-eva", name: "Red Alert EVA" },
   { id: "sc1-kerrigan", name: "SC1 Kerrigan" },
-  { id: "sc2-kerrigan", name: "SC2 Kerrigan" },
+  { id: "sc1-kerrigan-infested", name: "SC1 Infested Kerrigan" },
+  { id: "sc2-kerrigan-infested", name: "SC2 Infested Kerrigan" },
   { id: "sc1-protoss-advisor", name: "Protoss Advisor (SC1)" },
   { id: "sc2-protoss-advisor", name: "Protoss Advisor (SC2)" },
   { id: "ss1-shodan", name: "SHODAN" },

package/src/packs.js

@@ -146,6 +146,7 @@ export function loadPack(config) {
     voicePath,
     volumeOffsetDb: getVolumeOffsetDb(voicePath, packId),
     tts_params: packData.tts_params || null,
+    ref_text: packData.ref_text || null,
     audio_filter: packData.audio_filter || null,
     post_process: packData.post_process || null,
     style: packData.style || packData.system_prompt || null,

package/src/setup-ui.js

@@ -14,12 +14,12 @@ const ANSI = {
 };
 
 const LOGO_LINES = [
-  "██╗   ██╗ ██████╗ ██╗ ██████╗███████╗███████╗ ██████╗ ██████╗  ██████╗ ███████╗",
-  "██║   ██║██╔═══██╗██║██╔════╝██╔════╝██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝",
-  "██║   ██║██║   ██║██║██║     █████╗  █████╗  ██║   ██║██████╔╝██║  ███╗█████╗  ",
-  "╚██╗ ██╔╝██║   ██║██║██║     ██╔══╝  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  ",
-  " ╚████╔╝ ╚██████╔╝██║╚██████╗███████╗██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗",
-  "  ╚═══╝   ╚═════╝ ╚═╝ ╚═════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝",
+  "██╗   ██╗ ██████╗ ██╗  ██╗██╗     ███████╗██████╗ ████████╗",
+  "██║   ██║██╔═══██╗╚██╗██╔╝██║     ██╔════╝██╔══██╗╚══██╔══╝",
+  "██║   ██║██║   ██║ ╚███╔╝ ██║     █████╗  ██████╔╝   ██║   ",
+  "╚██╗ ██╔╝██║   ██║ ██╔██╗ ██║     ██╔══╝  ██╔══██╗   ██║   ",
+  " ╚████╔╝ ╚██████╔╝██╔╝ ██╗███████╗███████╗██║  ██║   ██║   ",
+  "  ╚═══╝   ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝   ╚═╝   ",
 ];
 
 function color(text, code) {
@@ -84,7 +84,7 @@ function animatedLogoLine(text, phase = 0, shimmerIndex = -1) {
   }).join("") + ANSI.reset;
 }
 
-function centerLine(text, width = 92) {
+function centerLine(text, width = 59) {
   const padding = Math.max(0, Math.floor((width - text.length) / 2));
   return `${" ".repeat(padding)}${text}`;
 }
@@ -98,8 +98,8 @@ function formatCurrentConfig(config, installedPlatforms) {
   const providerLabel = config.llm_api_key
     ? `${provider ? provider.name : (config.llm_backend || "openrouter")} (${config.llm_model || provider?.defaultModel || "default"})`
     : "Fallback only";
-  const ttsLabel = config.tts_backend || "chatterbox";
-  const voiceLabel = config.active_pack || "sc2-adjutant";
+  const ttsLabel = config.tts_backend || "qwen";
+  const voiceLabel = config.active_pack || "sc1-kerrigan-infested";
   const platforms = installedPlatforms.filter(Boolean);
   return [
     `${color("Current", ANSI.dim)} ${providerLabel}`,
@@ -111,18 +111,18 @@ function formatCurrentConfig(config, installedPlatforms) {
 
 function renderLogoFrame(config, installedPlatforms, shimmerStep = -1) {
   const current = formatCurrentConfig(config, installedPlatforms).map((line) => `  ${line}`);
-  const rule = color("┈".repeat(92), ANSI.dim);
+  const rule = color("┈".repeat(59), ANSI.dim);
   const glow = color("SYNTHETIC VOICE NOTIFICATIONS FOR AGENT WORKFLOWS", ANSI.cyan);
   const logo = LOGO_LINES.map((line, index) => {
     const shimmerIndex = shimmerStep >= 0 ? shimmerStep - index * 3 : -1;
     const phase = shimmerStep >= 0 ? shimmerStep * 0.015 + index * 0.02 : index * 0.02;
-    return centerLine(animatedLogoLine(line, phase, shimmerIndex), 92);
+    return centerLine(animatedLogoLine(line, phase, shimmerIndex), 59);
   });
   return [
     "",
     rule,
     ...logo,
-    centerLine(glow, 92),
+    centerLine(glow, 59),
     rule,
     "",
     ...current,

package/src/setup.js

@@ -23,8 +23,6 @@ import { registerCursorHooks, unregisterCursorHooks, hasCursorHooks } from "./cu
 import { registerCodexNotify, getCodexConfigPath, unregisterCodexNotify, hasCodexNotify } from "./codex-config.js";
 import { printSetupHeader, printStep, printStatus, printSuccess, printWarning, highlight } from "./setup-ui.js";
 import {
-  QWEN_DOCS_URL,
-  CHATTERBOX_DOCS_URL,
   probeTtsBackend,
   chooseTtsBackend,
   verifyTtsSetup,
@@ -38,64 +36,68 @@ function validateApiKey(providerId, apiKey) {
     const provider = getProvider(providerId);
     if (!provider) return resolve({ ok: false, error: "Unknown provider" });
 
-    let url;
-    let options;
-
-    const base = provider.baseUrl.replace(/\/+$/, "");
-
-    if (provider.format === "anthropic") {
-      // Anthropic: POST to /v1/messages with a tiny request
-      url = new URL(`${base}/v1/messages`);
-      const authHeaders = provider.authHeader(apiKey);
-      const payload = JSON.stringify({
-        model: provider.defaultModel,
-        max_tokens: 1,
-        messages: [{ role: "user", content: "hi" }],
-      });
-      options = {
-        method: "POST",
-        headers: {
-          ...authHeaders,
-          "Content-Type": "application/json",
-          "Content-Length": Buffer.byteLength(payload),
-        },
-        timeout: 8000,
-      };
-      const req = https.request(url, options, (res) => {
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
-          if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
-          resolve({ ok: res.statusCode < 500 });
+    try {
+      let url;
+      let options;
+
+      const base = provider.baseUrl.replace(/\/+$/, "");
+
+      if (provider.format === "anthropic") {
+        // Anthropic: POST to /v1/messages with a tiny request
+        url = new URL(`${base}/v1/messages`);
+        const authHeaders = provider.authHeader(apiKey);
+        const payload = JSON.stringify({
+          model: provider.defaultModel,
+          max_tokens: 1,
+          messages: [{ role: "user", content: "hi" }],
         });
-      });
-      req.on("error", (err) => resolve({ ok: false, error: err.message }));
-      req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
-      req.write(payload);
-      req.end();
-    } else {
-      // OpenAI-compatible: GET /models
-      url = new URL(`${base}/models`);
-      const authHeaders = provider.authHeader(apiKey);
-      options = {
-        method: "GET",
-        headers: { ...authHeaders },
-        timeout: 8000,
-      };
-      const reqFn = url.protocol === "https:" ? https.request : http.request;
-      const req = reqFn(url, options, (res) => {
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
-          if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
-          resolve({ ok: res.statusCode >= 200 && res.statusCode < 300 });
+        options = {
+          method: "POST",
+          headers: {
+            ...authHeaders,
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(payload),
+          },
+          timeout: 8000,
+        };
+        const req = https.request(url, options, (res) => {
+          let data = "";
+          res.on("data", (chunk) => (data += chunk));
+          res.on("end", () => {
+            if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
+            if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
+            resolve({ ok: res.statusCode < 500 });
+          });
+        });
+        req.on("error", (err) => resolve({ ok: false, error: err.message }));
+        req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
+        req.write(payload);
+        req.end();
+      } else {
+        // OpenAI-compatible: GET /models
+        url = new URL(`${base}/models`);
+        const authHeaders = provider.authHeader(apiKey);
+        options = {
+          method: "GET",
+          headers: { ...authHeaders },
+          timeout: 8000,
+        };
+        const reqFn = url.protocol === "https:" ? https.request : http.request;
+        const req = reqFn(url, options, (res) => {
+          let data = "";
+          res.on("data", (chunk) => (data += chunk));
+          res.on("end", () => {
+            if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
+            if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
+            resolve({ ok: res.statusCode >= 200 && res.statusCode < 300 });
+          });
         });
-      });
-      req.on("error", (err) => resolve({ ok: false, error: err.message }));
-      req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
-      req.end();
+        req.on("error", (err) => resolve({ ok: false, error: err.message }));
+        req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
+        req.end();
+      }
+    } catch (err) {
+      resolve({ ok: false, error: err.message });
     }
   });
 }
@@ -184,6 +186,21 @@ export async function runSetup() {
   mkdirSync(CACHE_DIR, { recursive: true });
 
   const config = loadConfig();
+
+  // Save partial progress on Ctrl+C so completed steps are preserved
+  const savePartial = () => {
+    try {
+      saveConfig(config);
+      console.log("");
+      printWarning("Setup interrupted — progress saved. Run 'voxlert setup' to resume.");
+      console.log("");
+    } catch {
+      // ignore write errors during exit
+    }
+  };
+  process.on("SIGINT", () => { savePartial(); process.exit(130); });
+
+  try {
   const currentBackend = config.llm_backend || "openrouter";
   const currentProvider = getProvider(currentBackend);
   const currentModel = config.llm_model || currentProvider?.defaultModel || "default";
@@ -238,7 +255,7 @@ export async function runSetup() {
       ? `${existingKey.slice(0, 4)}…${existingKey.slice(-4)}`
       : "";
 
-    apiKey = await input({
+    apiKey = (await input({
       message: "Paste your API key:",
       default: existingKey || undefined,
       transformer: (val) => {
@@ -247,7 +264,7 @@ export async function runSetup() {
         if (val.length <= 8) return "****";
         return val.slice(0, 4) + "…" + val.slice(-4);
       },
-    });
+    })).trim();
 
     if (apiKey) {
       process.stdout.write("  Validating key... ");
@@ -323,7 +340,7 @@ export async function runSetup() {
   }));
 
   const toDownload = await checkbox({
-    message: "Which voice packs do you want to install? (downloaded from GitHub)",
+    message: "Which voice packs do you want to install? (space = toggle, enter = confirm)",
     choices: packChoices,
     required: false,
   });
@@ -362,9 +379,9 @@ export async function runSetup() {
     ];
 
     const chosenPack = await select({
-      message: "Choose a voice pack:",
+      message: "Choose default voice:",
       choices: packChoices,
-      default: active || "sc2-adjutant",
+      default: active || "random",
     });
     config.active_pack = chosenPack;
   } else {
@@ -378,15 +395,13 @@ export async function runSetup() {
 
   printStatus("Recommended", "Qwen TTS for a more natural voice");
   printStatus("Voice test", `Uses the voice you picked in Step 4 (${config.active_pack || "default"})`);
-  printStatus("Qwen TTS setup docs", QWEN_DOCS_URL);
-  printStatus("Chatterbox setup docs", CHATTERBOX_DOCS_URL);
   console.log("");
 
-  process.stdout.write("  Checking Chatterbox (port 8004)... ");
+  process.stdout.write("  Checking Chatterbox... ");
   const chatterboxUp = await probeTtsBackend(config, "chatterbox");
   console.log(chatterboxUp ? "detected!" : "not running");
 
-  process.stdout.write("  Checking Qwen TTS (port 8100)...   ");
+  process.stdout.write("  Checking Qwen TTS... ");
   const qwenUp = await probeTtsBackend(config, "qwen");
   console.log(qwenUp ? "detected!" : "not running");
 
@@ -419,7 +434,7 @@ export async function runSetup() {
   ];
 
   const selectedPlatforms = await checkbox({
-    message: "Which platforms do you want to install hooks for?",
+    message: "Which platforms do you want to install hooks for? (space = toggle, enter = confirm)",
     choices: platformChoices,
     required: false,
   });
@@ -501,4 +516,13 @@ export async function runSetup() {
   }
   printStatus("Reconfigure", "voxlert setup");
   console.log("");
+
+  } catch (err) {
+    // Inquirer throws on Ctrl+C (ExitPromptError); save partial progress
+    if (err && (err.name === "ExitPromptError" || err.message === "Prompt was canceled")) {
+      savePartial();
+      return;
+    }
+    throw err;
+  }
 }

package/src/tts-test.js

@@ -1,8 +1,7 @@
-import { writeFileSync, unlinkSync, existsSync } from "fs";
+import { writeFileSync, readFileSync, unlinkSync, existsSync } from "fs";
 import { join } from "path";
 import { request as httpsRequest } from "https";
 import { request as httpRequest } from "http";
-import confirm from "@inquirer/confirm";
 import select from "@inquirer/select";
 import { playFile } from "./audio.js";
 import { loadPack } from "./packs.js";
@@ -38,15 +37,17 @@ export function getTtsChoices(currentBackend) {
   return [
     {
       name: currentBackend === "qwen"
-        ? "Qwen TTS (recommended, current, more natural voice, port 8100)"
-        : "Qwen TTS (recommended, more natural voice, port 8100)",
+        ? "Qwen TTS (recommended, current, more natural voice)"
+        : "Qwen TTS (recommended, more natural voice)",
       value: "qwen",
+      description: `Setup docs: ${QWEN_DOCS_URL}`,
     },
     {
       name: currentBackend === "chatterbox"
-        ? "Chatterbox (current, port 8004)"
-        : "Chatterbox (port 8004)",
+        ? "Chatterbox (current)"
+        : "Chatterbox",
       value: "chatterbox",
+      description: `Setup docs: ${CHATTERBOX_DOCS_URL}`,
     },
   ];
 }
@@ -78,11 +79,69 @@ export function probeTtsBackend(config, backend, timeoutMs = 2000) {
   });
 }
 
-function requestTtsAudio(config, backend, pack) {
+function _registerVoiceForTest(config, pack) {
+  return new Promise((resolve) => {
+    const voicePath = pack.voicePath;
+    const refText = pack.ref_text;
+    if (!voicePath || !existsSync(voicePath) || !refText) return resolve(null);
+
+    const qwenUrl = config.qwen_tts_url || "http://localhost:8100";
+    const endpoint = `${qwenUrl}/voices`;
+
+    let audioData;
+    try { audioData = readFileSync(voicePath); } catch { return resolve(null); }
+
+    const boundary = `----VoxlertBoundary${Date.now()}`;
+    const parts = [];
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="ref_text"\r\n\r\n${refText}\r\n`,
+    ));
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="audio"; filename="voice.wav"\r\n` +
+      `Content-Type: audio/wav\r\n\r\n`,
+    ));
+    parts.push(audioData);
+    parts.push(Buffer.from(`\r\n--${boundary}--\r\n`));
+    const body = Buffer.concat(parts);
+
+    const url = new URL(endpoint);
+    const requestFn = url.protocol === "https:" ? httpsRequest : httpRequest;
+    const req = requestFn(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": `multipart/form-data; boundary=${boundary}`,
+        "Content-Length": body.length,
+      },
+      timeout: 15000,
+    }, (res) => {
+      if (res.statusCode < 200 || res.statusCode >= 300) { res.resume(); return resolve(null); }
+      const chunks = [];
+      res.on("data", (c) => chunks.push(c));
+      res.on("end", () => {
+        try {
+          const result = JSON.parse(Buffer.concat(chunks).toString());
+          resolve(result.voice_id || null);
+        } catch { resolve(null); }
+      });
+      res.on("error", () => resolve(null));
+    });
+    req.on("error", () => resolve(null));
+    req.on("timeout", () => { req.destroy(); resolve(null); });
+    req.write(body);
+    req.end();
+  });
+}
+
+async function requestTtsAudio(config, backend, pack) {
+  let voiceId = null;
+  if (backend === "qwen") {
+    voiceId = await _registerVoiceForTest(config, pack);
+  }
+
   return new Promise((resolve) => {
     const endpoint = getTtsEndpoint(config, backend);
     const body = backend === "qwen"
-      ? { text: TTS_TEST_PHRASE, pack_id: pack.id || "_default" }
+      ? { text: TTS_TEST_PHRASE, ...(voiceId ? { voice_id: voiceId } : {}) }
       : {
           text: TTS_TEST_PHRASE,
           voice_mode: "predefined",
@@ -157,26 +216,19 @@ export async function runTtsSample(config, backend) {
 }
 
 export async function chooseTtsBackend(config, { qwenUp, chatterboxUp }) {
-  if (qwenUp && chatterboxUp) {
-    return select({
-      message: "Both TTS servers detected. Which one to use? Qwen TTS is recommended for a more natural voice.",
-      choices: getTtsChoices(config.tts_backend),
-      default: config.tts_backend || "qwen",
-    });
-  }
-
-  if (qwenUp) {
-    printSuccess("Using Qwen TTS.");
-    return "qwen";
-  }
+  const detected = [qwenUp && "Qwen TTS", chatterboxUp && "Chatterbox"].filter(Boolean);
+  const hint = detected.length > 0
+    ? `Detected: ${detected.join(", ")}. `
+    : "";
 
-  if (chatterboxUp) {
-    printSuccess("Using Chatterbox.");
-    return "chatterbox";
+  if (!qwenUp && !chatterboxUp) {
+    printStatus("Note", "Local TTS needs a GPU or Apple Silicon. If that's a blocker:");
+    printStatus("Hosted option", "https://settinghead.github.io/pipevox-signup");
+    console.log("");
   }
 
   return select({
-    message: "Choose the TTS backend you are setting up. Qwen TTS is recommended for a more natural voice.",
+    message: `${hint}Choose the TTS backend. Qwen TTS is recommended for a more natural voice.`,
     choices: getTtsChoices(config.tts_backend),
     default: config.tts_backend || "qwen",
   });
@@ -186,20 +238,31 @@ export async function verifyTtsSetup(config, backend) {
   const label = getTtsLabel(backend);
   const docsUrl = getTtsDocsUrl(backend);
 
+  const retryOrSkip = [
+    { name: "I have set up the TTS server. Try again.", value: "retry" },
+    { name: "Skip setup (you won't hear any voice!)", value: "skip" },
+  ];
+
+  let attempt = 0;
   while (true) {
+    attempt++;
+    if (attempt > 1) {
+      console.log("\n  ── Retry #" + (attempt - 1) + " ──");
+    }
     console.log("");
     process.stdout.write(`  Checking ${label}... `);
     const backendUp = await probeTtsBackend(config, backend);
     console.log(backendUp ? "detected!" : "not running");
 
     if (!backendUp) {
-      printWarning(`${label} is not running yet. Finish that setup and come back here to try again.`);
+      printWarning(`${label} is not running yet.`);
       printStatus(`${label} docs`, docsUrl);
       console.log("");
-      await confirm({
-        message: `Press enter after ${label} is running to test again.`,
-        default: true,
-      });
+      const action = await select({ message: "What would you like to do?", choices: retryOrSkip });
+      if (action === "skip") {
+        printWarning("Skipped TTS verification. Voice notifications won't work until the server is running.");
+        return;
+      }
       continue;
     }
 
@@ -208,36 +271,39 @@ export async function verifyTtsSetup(config, backend) {
     console.log(ok ? "played." : "failed.");
 
     if (!ok) {
-      printWarning(`The ${label} test failed. Keep the docs open, fix the server, and try again.`);
+      printWarning(`The ${label} test failed.`);
       printStatus(`${label} docs`, docsUrl);
       console.log("");
-      await confirm({
-        message: `Press enter to retry the ${label} test.`,
-        default: true,
-      });
+      const action = await select({ message: "What would you like to do?", choices: retryOrSkip });
+      if (action === "skip") {
+        printWarning("Skipped TTS verification. Voice notifications won't work until the server is fixed.");
+        return;
+      }
       continue;
     }
 
     const heardVoice = await select({
       message: `Did you hear the ${label} voice test?`,
       choices: [
-        { name: "Yes", value: true },
-        { name: "No", value: false },
+        { name: "Yes", value: "yes" },
+        { name: "No, try again", value: "retry" },
+        { name: "Skip (you won't hear any voice!)", value: "skip" },
       ],
-      default: true,
     });
 
-    if (heardVoice) {
+    if (heardVoice === "yes") {
       printSuccess(`${label} verified.`);
       return;
     }
 
-    printWarning("No workaround here. Keep troubleshooting and retry until you hear the voice.");
+    if (heardVoice === "skip") {
+      printWarning("Skipped TTS verification. Voice notifications won't work until the server is fixed.");
+      return;
+    }
+
+    printWarning("Still not working? Local TTS requires specific hardware (Apple Silicon or NVIDIA GPU).");
+    printStatus("Hosted option", "https://settinghead.github.io/pipevox-signup — no local TTS needed");
     printStatus(`${label} docs`, docsUrl);
     console.log("");
-    await confirm({
-      message: "Press enter to play the test again.",
-      default: true,
-    });
   }
 }

package/src/voxlert.js

@@ -155,7 +155,7 @@ export async function processHookEvent(eventData) {
     }
   }
 
-  const packId = config.active_pack || "sc2-adjutant";
+  const packId = config.active_pack || "sc1-kerrigan-infested";
   const phraseOneLine = phrase.replace(/\s+/g, " ").slice(0, 120);
   debugLog("processHookEvent speaking", { source, phrase: phraseOneLine });
   appendLog(