pi-voice-input 0.2.8 → 0.2.9

package/README.md

@@ -10,13 +10,13 @@ A publishable, pure TypeScript [pi](https://pi.dev/) extension for Linux and mac
 Current scope:
 
 - Linux uses `pw-record` from PipeWire tools or `arecord` from alsa-utils.
-- macOS uses the system `afrecord` command. This path is implemented but not yet validated by the maintainer on macOS hardware.
+- macOS uses `afrecord` when present, otherwise `ffmpeg` with AVFoundation.
 - A VolcEngine Speech API key is required.
 - This is not a local/offline ASR engine.
 
 The provider layer is intended to be extensible. **Current version supports only VolcEngine WebSocket ASR.**
 
-No Python, `uv`, upload service, or `ffmpeg` is required for normal shortcut usage.
+No Python, `uv`, or upload service is required for normal shortcut usage. On macOS systems without `afrecord`, install `ffmpeg` for recording.
 
 ## Architecture
 
@@ -26,7 +26,7 @@ pi extension: extensions/voice-input.ts
   ├─ starts/stops a local recorder process
   │    ├─ Linux preferred: pw-record
   │    ├─ Linux fallback: arecord
-  │    └─ macOS: afrecord
+  │    └─ macOS: afrecord, or ffmpeg/AVFoundation fallback
   ├─ records a temporary 16 kHz mono 16-bit WAV
   ├─ parses the WAV container in TypeScript and extracts raw PCM
   ├─ sends PCM frames to the configured ASR provider via ws
@@ -44,9 +44,9 @@ System dependency, one of:
 
 - Linux: `pw-record` from PipeWire tools, preferred
 - Linux: `arecord` from alsa-utils, fallback
-- macOS: `afrecord`, included with macOS
+- macOS: `afrecord` when present, or `ffmpeg` from Homebrew (`brew install ffmpeg`) as the AVFoundation fallback
 
-On macOS, grant Terminal or your pi host app microphone permission when prompted. If macOS has previously denied microphone access, enable it in System Settings → Privacy & Security → Microphone.
+On macOS, grant Terminal, ffmpeg, or your pi host app microphone permission when prompted. If macOS has previously denied microphone access, enable it in System Settings → Privacy & Security → Microphone.
 
 ## Install / Update
 

package/extensions/voice-input.ts

@@ -217,7 +217,10 @@ function commandOutput(command: string, args: string[], timeoutMs = 1500): strin
 }
 
 function selectRecorderExecutable(): string {
-  if (platform() === "darwin" && commandExists("afrecord")) return "afrecord";
+  if (platform() === "darwin") {
+    if (commandExists("afrecord")) return "afrecord";
+    if (commandExists("ffmpeg")) return "ffmpeg";
+  }
   if (commandExists("pw-record")) return "pw-record";
   if (commandExists("arecord")) return "arecord";
   return "";
@@ -237,7 +240,31 @@ function recorderCommand(config: VoiceConfig, outputPath: string): string[] {
   if (executable === "afrecord") {
     return ["afrecord", "-f", "WAVE", "-d", "LEI16@16000", "-c", "1", outputPath];
   }
-  throw new Error("No recorder found. On Linux, install PipeWire tools (pw-record) or alsa-utils (arecord). On macOS, afrecord should be available with the system.");
+  if (executable === "ffmpeg" && platform() === "darwin") {
+    return [
+      "ffmpeg",
+      "-hide_banner",
+      "-loglevel",
+      "error",
+      "-nostdin",
+      "-y",
+      "-f",
+      "avfoundation",
+      "-i",
+      config.recorderTarget || "none:default",
+      "-vn",
+      "-acodec",
+      "pcm_s16le",
+      "-ar",
+      "16000",
+      "-ac",
+      "1",
+      "-f",
+      "wav",
+      outputPath,
+    ];
+  }
+  throw new Error("No recorder found. On Linux, install PipeWire tools (pw-record) or alsa-utils (arecord). On macOS, install ffmpeg (brew install ffmpeg) if afrecord is not available.");
 }
 
 type PipeWireSource = {
@@ -326,6 +353,7 @@ function recordingDeviceName(config: VoiceConfig, recorderExecutable: string): s
   if (recorderExecutable === "pw-record") return pipeWireSourceName(config.recorderTarget);
   if (recorderExecutable === "arecord") return "ALSA default microphone";
   if (recorderExecutable === "afrecord") return "macOS default microphone";
+  if (recorderExecutable === "ffmpeg" && platform() === "darwin") return "macOS default microphone (ffmpeg/AVFoundation)";
   return config.recorderTarget || "default microphone";
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-voice-input",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Press Ctrl+Shift+R to dictate prompts into Pi using VolcEngine ASR",
   "type": "module",
   "keywords": [