klaudio 0.11.1 → 0.11.3

package/README.md

@@ -1,96 +1,96 @@
-# klaudio
-
-Add sound effects to your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions. Plays sounds when Claude finishes a task, sends a notification, and more.
-
-## Quick Start
-
-```bash
-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, 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. **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
-
-### Built-in Presets
-
-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:
-
-- 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 `~/.klaudio/cache/` for instant reuse
-
-### Custom Files
-
-Point to your own `.wav`/`.mp3` files.
-
-## Music Player
-
-Play longer game tracks (30s–10min) as background music while you code:
-
-- **Shuffle all** — scans all cached game audio, filters by duration, picks random tracks continuously
-- **Play songs from game** — pick a specific cached game and play its music
-- Controls: `n` next, `space` pause/resume, `esc` back
-- Background scanning — starts playing as soon as the first track is found, keeps indexing
-
-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 1–2 sentences of Claude's last message (up to ~25 words), preserving version numbers and filenames
-- 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
-- **Re-apply current sounds** — re-running the installer shows your current selections with a quick re-apply option
-
-## Events
-
-| Event | Triggers when |
-|---|---|
-| Notification | Claude needs your attention |
-| Task Complete | Claude finishes a response |
-
-## Uninstall
-
-```bash
-npx klaudio --uninstall
-```
-
-## Requirements
-
-- 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 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.
+# klaudio
+
+Add sound effects to your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions. Plays sounds when Claude finishes a task, sends a notification, and more.
+
+## Quick Start
+
+```bash
+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, 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. **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
+
+### Built-in Presets
+
+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:
+
+- 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 `~/.klaudio/cache/` for instant reuse
+
+### Custom Files
+
+Point to your own `.wav`/`.mp3` files.
+
+## Music Player
+
+Play longer game tracks (30s–10min) as background music while you code:
+
+- **Shuffle all** — scans all cached game audio, filters by duration, picks random tracks continuously
+- **Play songs from game** — pick a specific cached game and play its music
+- Controls: `n` next, `space` pause/resume, `esc` back
+- Background scanning — starts playing as soon as the first track is found, keeps indexing
+
+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 1–2 sentences of Claude's last message (up to ~25 words), preserving version numbers and filenames
+- 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
+- **Re-apply current sounds** — re-running the installer shows your current selections with a quick re-apply option
+
+## Events
+
+| Event | Triggers when |
+|---|---|
+| Notification | Claude needs your attention |
+| Task Complete | Claude finishes a response |
+
+## Uninstall
+
+```bash
+npx klaudio --uninstall
+```
+
+## Requirements
+
+- 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 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/bin/cli.js

@@ -1,45 +1,45 @@
 #!/usr/bin/env node
-
-// 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 notify "title" "body"
-if (process.argv[2] === "notify") {
-  const title = process.argv[3] || "klaudio";
-  const body = process.argv[4] || "";
-  if (body) {
-    const { sendNotification } = await import("../src/notify.js");
-    await sendNotification(title, body);
-  }
-  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");
-
-run().catch((err) => {
-  if (err.name === "ExitPromptError") {
-    // User pressed Ctrl+C
-    console.log("\n  Cancelled.\n");
-    process.exit(0);
-  }
-  console.error(err);
-  process.exit(1);
-});
+
+// 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 notify "title" "body"
+if (process.argv[2] === "notify") {
+  const title = process.argv[3] || "klaudio";
+  const body = process.argv[4] || "";
+  if (body) {
+    const { sendNotification } = await import("../src/notify.js");
+    await sendNotification(title, body);
+  }
+  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");
+
+run().catch((err) => {
+  if (err.name === "ExitPromptError") {
+    // User pressed Ctrl+C
+    console.log("\n  Cancelled.\n");
+    process.exit(0);
+  }
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,44 +1,40 @@
-{
-  "name": "klaudio",
-  "version": "0.11.1",
-  "description": "Add sound effects to your coding sessions — play sounds when tasks complete, notifications arrive, and more",
-  "type": "module",
-  "bin": {
-    "klaudio": "./bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "sounds/"
-  ],
-  "scripts": {
-    "generate-sounds": "node scripts/generate-sounds.js",
-    "start": "node bin/cli.js",
-    "build": "bun run build.js",
-    "build:all": "bun run build.js --all"
-  },
-  "keywords": [
-    "klonk",
-    "sounds",
-    "sfx",
-    "hooks",
-    "notifications",
-    "audio",
-    "claude-code",
-    "coding-tools"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "ink": "^6.8.0",
-    "ink-select-input": "^6.2.0",
-    "ink-spinner": "^5.0.0",
-    "react": "^19.2.4"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/needle-tools/klaudio.git"
-  }
-}
+{
+  "name": "klaudio",
+  "version": "0.11.3",
+  "description": "Add sound effects to your coding sessions — play sounds when tasks complete, notifications arrive, and more",
+  "type": "module",
+  "bin": {
+    "klaudio": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "sounds/"
+  ],
+  "scripts": {
+    "generate-sounds": "node scripts/generate-sounds.js",
+    "start": "node bin/cli.js",
+    "build": "bun run build.js",
+    "build:all": "bun run build.js --all"
+  },
+  "keywords": [
+    "klonk",
+    "sounds",
+    "sfx",
+    "hooks",
+    "notifications",
+    "audio",
+    "claude-code",
+    "coding-tools"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "ink": "^6.8.0",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "react": "^19.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}