@bryan-gc/transcribe-cli 1.0.0

package/README.md

@@ -0,0 +1,46 @@
+# transcribe-cli
+
+Una aplicación de terminal (CLI) escrita en Node.js y TypeScript para grabar audio desde el micrófono y transcribirlo utilizando la API Whisper de OpenAI.
+
+## Requisitos Previos del Sistema (Importante)
+
+Para que Node.js pueda grabar audio desde tu micrófono, necesita apoyarse en herramientas del sistema operativo. Dependiendo de tu sistema, debes instalar lo siguiente **antes** de correr el proyecto:
+
+### Linux (Ubuntu / Debian)
+Necesitas instalar `sox` y las librerías de soporte de formatos de audio:
+```bash
+sudo apt-get update
+sudo apt-get install sox libsox-fmt-all
+```
+
+### macOS
+Puedes instalar `sox` usando Homebrew:
+```bash
+brew install sox
+```
+
+### Windows
+1. Descarga los binarios de [SoX](https://sourceforge.net/projects/sox/).
+2. Añade la carpeta donde extrajiste SoX a tu variable de entorno `PATH`.
+
+---
+
+## Instalación del Proyecto
+
+1. Clona el repositorio o descarga los archivos.
+2. Instala las dependencias de Node:
+   ```bash
+   npm install
+   ```
+3. Al iniciar la aplicación por primera vez, un prompt interactivo te pedirá tu **API Key de OpenAI** y la **ruta base** para guardar los audios y glosarios. Estos datos se guardarán de forma persistente en `~/.transcribe-cli/config.json`.
+
+## Uso
+
+Para iniciar la aplicación, simplemente corre:
+```bash
+npm start
+```
+
+La aplicación mostrará un menú interactivo en la terminal. Puedes controlarlo de dos formas:
+- **Flechas Direccionales:** Usa Arriba/Abajo para moverte y Enter para seleccionar una opción.
+- **Atajos de Teclado:** Presiona `r` para grabar, `p` para pausar, `s` para detener y `t` para transcribir.

package/dist/audio/audioPlayer.d.ts

@@ -0,0 +1,7 @@
+export declare function stopPlayback(): void;
+/**
+ * Plays a WAV file. Tries 'play' (sox) first, falls back to 'aplay' on Linux,
+ * or 'afplay' on macOS. Resolves when playback finishes or is stopped.
+ */
+export declare function playAudio(filepath: string): Promise<void>;
+//# sourceMappingURL=audioPlayer.d.ts.map

package/dist/audio/audioPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioPlayer.d.ts","sourceRoot":"","sources":["../../src/audio/audioPlayer.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,SAK3B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzD"}

package/dist/audio/audioPlayer.js

@@ -0,0 +1,49 @@
+import { spawn } from 'child_process';
+import { execSync } from 'child_process';
+import os from 'os';
+import { Platform, Cmd, Signal, ProcessEvent, StdioOption } from '../constants';
+let playProcess = null;
+export function stopPlayback() {
+    if (playProcess) {
+        playProcess.kill(Signal.SIGTERM);
+        playProcess = null;
+    }
+}
+/**
+ * Plays a WAV file. Tries 'play' (sox) first, falls back to 'aplay' on Linux,
+ * or 'afplay' on macOS. Resolves when playback finishes or is stopped.
+ */
+export function playAudio(filepath) {
+    stopPlayback();
+    const platform = os.platform();
+    const getCmdArgs = () => {
+        if (platform === Platform.DARWIN) {
+            return { cmd: Cmd.AFPLAY, args: [filepath] };
+        }
+        // Try sox's 'play' first (already installed for recording)
+        try {
+            execSync(`which ${Cmd.PLAY}`, { stdio: StdioOption.IGNORE });
+            return { cmd: Cmd.PLAY, args: [filepath] };
+        }
+        catch {
+            return { cmd: Cmd.APLAY, args: [filepath] };
+        }
+    };
+    const { cmd, args } = getCmdArgs();
+    return new Promise((resolve, reject) => {
+        playProcess = spawn(cmd, args, { stdio: StdioOption.IGNORE });
+        playProcess.on(ProcessEvent.CLOSE, (code) => {
+            playProcess = null;
+            if (code === null || code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`Playback exited with code ${code}`));
+        });
+        playProcess.on(ProcessEvent.ERROR, (err) => {
+            playProcess = null;
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=audioPlayer.js.map

package/dist/audio/audioPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioPlayer.js","sourceRoot":"","sources":["../../src/audio/audioPlayer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhF,IAAI,WAAW,GAAwB,IAAI,CAAC;AAE5C,MAAM,UAAU,YAAY;IAC1B,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,YAAY,EAAE,CAAC;IAEf,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,GAAoC,EAAE;QACvD,IAAI,QAAQ,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACjC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,CAAC;QACD,2DAA2D;QAC3D,IAAI,CAAC;YACH,QAAQ,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;IAEnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,WAAW,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1C,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACzC,WAAW,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/audio/micDevices.d.ts

@@ -0,0 +1,17 @@
+export interface MicDevice {
+    id: string;
+    label: string;
+}
+/**
+ * Detects the current platform and returns a list of available
+ * microphone/capture devices dynamically.
+ *
+ * Supported platforms:
+ *   - Linux  → uses `arecord -L` (ALSA)
+ *   - macOS  → uses `system_profiler SPAudioDataType`
+ *   - Windows → falls back to "Default Device" (sox handles selection natively)
+ *
+ * Always includes a "Default Device" entry as a safe fallback.
+ */
+export declare function listMicDevices(): MicDevice[];
+//# sourceMappingURL=micDevices.d.ts.map

package/dist/audio/micDevices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micDevices.d.ts","sourceRoot":"","sources":["../../src/audio/micDevices.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAe5C"}

package/dist/audio/micDevices.js

@@ -0,0 +1,120 @@
+import { execSync } from 'child_process';
+import os from 'os';
+import { DEFAULT_DEVICE_ID, DEFAULT_DEVICE_LABEL, Platform, Cmd, Encoding, AlsaDevice, ALSA_VIRTUAL_DEVICES, } from '../constants';
+/**
+ * Detects the current platform and returns a list of available
+ * microphone/capture devices dynamically.
+ *
+ * Supported platforms:
+ *   - Linux  → uses `arecord -L` (ALSA)
+ *   - macOS  → uses `system_profiler SPAudioDataType`
+ *   - Windows → falls back to "Default Device" (sox handles selection natively)
+ *
+ * Always includes a "Default Device" entry as a safe fallback.
+ */
+export function listMicDevices() {
+    const platform = os.platform();
+    try {
+        if (platform === Platform.LINUX) {
+            return listLinuxDevices();
+        }
+        if (platform === Platform.DARWIN) {
+            return listMacDevices();
+        }
+    }
+    catch {
+        // If detection fails for any reason, fall back silently
+    }
+    return [{ id: DEFAULT_DEVICE_ID, label: DEFAULT_DEVICE_LABEL }];
+}
+// ─── Linux (ALSA via arecord / PipeWire via pw-dump) ──────────────────────────
+function listLinuxDevices() {
+    const devices = [{ id: DEFAULT_DEVICE_ID, label: DEFAULT_DEVICE_LABEL }];
+    // 1. Try PipeWire (pw-dump) for user-friendly names matching Ubuntu settings
+    try {
+        const rawPw = execSync(`${Cmd.PW_DUMP} 2>/dev/null`, { encoding: Encoding.UTF8 });
+        const nodes = JSON.parse(rawPw);
+        let foundPwDevices = false;
+        for (const node of nodes) {
+            const props = node?.info?.props;
+            if (props && props['media.class'] === 'Audio/Source') {
+                const id = props['node.name'];
+                const label = props['node.description'] || id;
+                if (id) {
+                    devices.push({ id, label });
+                    foundPwDevices = true;
+                }
+            }
+        }
+        if (foundPwDevices) {
+            return devices;
+        }
+    }
+    catch {
+        // Fallback to arecord if pw-dump fails or isn't installed
+    }
+    // 2. Fallback to ALSA (arecord -L)
+    try {
+        const raw = execSync(`${Cmd.ARECORD} -L 2>/dev/null`, { encoding: Encoding.UTF8 });
+        // Top-level lines (no leading whitespace) are device IDs.
+        // Lines starting with spaces are descriptions → skip them.
+        const topLevel = raw
+            .split('\n')
+            .filter((line) => line.trim() && !line.startsWith(' ') && !line.startsWith('\t'));
+        for (const id of topLevel) {
+            if (ALSA_VIRTUAL_DEVICES.has(id) || id === DEFAULT_DEVICE_ID)
+                continue;
+            devices.push({ id, label: formatAlsaLabel(id) });
+        }
+    }
+    catch {
+        // Ignore error
+    }
+    return devices;
+}
+function formatAlsaLabel(id) {
+    if (id === AlsaDevice.PULSE)
+        return 'PulseAudio';
+    if (id === AlsaDevice.PIPEWIRE)
+        return 'PipeWire';
+    // plughw:CARD=sofhdadsp,DEV=0  →  "sofhdadsp  DEV 0 (plug)"
+    const hwMatch = id.match(/^(plughw|hw):CARD=([^,]+),DEV=(\d+)$/);
+    if (hwMatch) {
+        const plug = hwMatch[1] === AlsaDevice.PLUGHW ? ' (plug)' : '';
+        return `${hwMatch[2]}  DEV ${hwMatch[3]}${plug}`;
+    }
+    // sysdefault:CARD=X  →  "X (sysdefault)"
+    const sysMatch = id.match(/^sysdefault:CARD=(.+)$/);
+    if (sysMatch)
+        return `${sysMatch[1]} (sysdefault)`;
+    // dsnoop:CARD=X,DEV=N  →  "X  DEV N (dsnoop)"
+    const dsnoopMatch = id.match(/^dsnoop:CARD=([^,]+),DEV=(\d+)$/);
+    if (dsnoopMatch)
+        return `${dsnoopMatch[1]}  DEV ${dsnoopMatch[2]} (dsnoop)`;
+    return id;
+}
+// ─── macOS (system_profiler) ──────────────────────────────────────────────────
+function listMacDevices() {
+    const raw = execSync(`${Cmd.SYSTEM_PROFILER} SPAudioDataType 2>/dev/null`, {
+        encoding: Encoding.UTF8,
+    });
+    const devices = [{ id: DEFAULT_DEVICE_ID, label: DEFAULT_DEVICE_LABEL }];
+    // system_profiler outputs sections like:
+    //     Built-in Microphone:
+    //       Input Channels: 1
+    //       …
+    // We grab names of sections that contain "Input Channels" (i.e., are inputs).
+    const sections = raw.split(/\n(?=\s{4}\S)/);
+    for (const section of sections) {
+        if (!section.includes('Input Channels'))
+            continue;
+        const nameLine = section.match(/^\s{4}(.+):$/m);
+        if (nameLine) {
+            const label = nameLine[1].trim();
+            // sox on macOS uses device names directly
+            devices.push({ id: label, label });
+        }
+    }
+    return devices.length > 1 ? devices : [{ id: DEFAULT_DEVICE_ID, label: DEFAULT_DEVICE_LABEL }];
+}
+//# sourceMappingURL=micDevices.js.map

package/dist/audio/micDevices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"micDevices.js","sourceRoot":"","sources":["../../src/audio/micDevices.ts"],"names":[],"mappings":"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"}

package/dist/audio/recorder.d.ts

@@ -0,0 +1,16 @@
+export declare class AudioRecorder {
+    private cp;
+    private fileStream;
+    private filepath;
+    private device;
+    private _isPaused;
+    setDevice(device: string): void;
+    getDevice(): string;
+    start(filepath: string): void;
+    pause(): void;
+    resume(): void;
+    /** Stops the recording and resolves only when the audio file has been fully written to disk. */
+    stop(): Promise<void>;
+    getFilepath(): string;
+}
+//# sourceMappingURL=recorder.d.ts.map

package/dist/audio/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/audio/recorder.ts"],"names":[],"mappings":"AAiBA,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoE7B,KAAK,IAAI,IAAI;IAab,MAAM,IAAI,IAAI;IAOd,gGAAgG;IAChG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDrB,WAAW,IAAI,MAAM;CAGtB"}

package/dist/audio/recorder.js

@@ -0,0 +1,149 @@
+import { spawn } from 'child_process';
+import fs from 'fs';
+import os from 'os';
+import { DEFAULT_DEVICE_ID, Platform, Cmd, Signal, AUDIO_CONFIG, ALSA_PREFIXES, Encoding, StdioOption, StreamEvent, ProcessEvent, } from '../constants';
+export class AudioRecorder {
+    cp = null;
+    fileStream = null;
+    filepath = '';
+    device = DEFAULT_DEVICE_ID;
+    _isPaused = false;
+    setDevice(device) {
+        if (this.cp) {
+            throw new Error('Cannot change device while recording is in progress.');
+        }
+        this.device = device;
+    }
+    getDevice() {
+        return this.device;
+    }
+    start(filepath) {
+        if (this.cp) {
+            throw new Error('A recording is already in progress.');
+        }
+        this.filepath = filepath;
+        this.fileStream = fs.createWriteStream(filepath, { encoding: Encoding.BINARY });
+        this._isPaused = false;
+        let env = process.env;
+        if (os.platform() === Platform.DARWIN) {
+            const args = [
+                '-d',
+                '-q',
+                '-r',
+                AUDIO_CONFIG.SAMPLE_RATE,
+                '-c',
+                AUDIO_CONFIG.CHANNELS,
+                '-e',
+                AUDIO_CONFIG.ENCODING_SOX,
+                '-b',
+                AUDIO_CONFIG.BITS,
+                '-t',
+                AUDIO_CONFIG.TYPE,
+                '-',
+            ];
+            if (this.device !== DEFAULT_DEVICE_ID) {
+                env = { ...process.env, AUDIODEV: this.device };
+            }
+            this.cp = spawn(Cmd.SOX, args, {
+                stdio: [StdioOption.IGNORE, StdioOption.PIPE, StdioOption.IGNORE],
+                env,
+            });
+            this.cp.stdout?.pipe(this.fileStream);
+            return;
+        }
+        // Linux (arecord)
+        const args = [
+            '-q',
+            '-f',
+            AUDIO_CONFIG.FORMAT_ARECORD,
+            '-c',
+            AUDIO_CONFIG.CHANNELS,
+            '-r',
+            AUDIO_CONFIG.SAMPLE_RATE,
+            '-t',
+            AUDIO_CONFIG.TYPE,
+        ];
+        if (this.device !== DEFAULT_DEVICE_ID) {
+            // If the device ID is from PipeWire/PulseAudio (e.g. alsa_input.usb-...)
+            // we use the 'pulse' ALSA device and tell Pulse/PipeWire which source to use.
+            const isPulse = this.device.startsWith(ALSA_PREFIXES.ALSA_INPUT) ||
+                this.device.startsWith(ALSA_PREFIXES.BLUEZ_INPUT);
+            args.push('-D', isPulse ? AUDIO_CONFIG.DEVICE_PULSE : this.device);
+            if (isPulse)
+                env = { ...process.env, PULSE_SOURCE: this.device };
+        }
+        this.cp = spawn(Cmd.ARECORD, args, {
+            stdio: [StdioOption.IGNORE, StdioOption.PIPE, StdioOption.IGNORE],
+            env,
+        });
+        this.cp.stdout?.pipe(this.fileStream);
+    }
+    pause() {
+        if (!this.cp || this._isPaused)
+            return;
+        // Delaying the SIGSTOP by a short moment allows the OS audio buffer to flush
+        // the last spoken words before the process freezes.
+        setTimeout(() => {
+            if (!this.cp || this._isPaused)
+                return;
+            this.cp.kill(Signal.SIGSTOP);
+            this._isPaused = true;
+        }, 500);
+    }
+    resume() {
+        if (!this.cp || !this._isPaused)
+            return;
+        this.cp.kill(Signal.SIGCONT);
+        this._isPaused = false;
+    }
+    /** Stops the recording and resolves only when the audio file has been fully written to disk. */
+    stop() {
+        return new Promise((resolve) => {
+            if (!this.cp) {
+                resolve();
+                return;
+            }
+            // If the process was paused, we MUST resume it first so it can process
+            // the SIGINT/SIGTERM and flush any remaining buffer.
+            if (this._isPaused) {
+                this.cp.kill(Signal.SIGCONT);
+                this._isPaused = false;
+            }
+            // Wait a brief moment to capture the trailing audio from the hardware buffer
+            setTimeout(() => {
+                if (this.cp) {
+                    // Attempt a graceful exit first (SIGINT) so wav headers and buffers can be flushed
+                    this.cp.kill(Signal.SIGINT);
+                    // Safety fallback to SIGTERM if it doesn't exit
+                    const fallback = setTimeout(() => {
+                        if (this.cp)
+                            this.cp.kill(Signal.SIGTERM);
+                    }, 500);
+                    this.cp.on(ProcessEvent.EXIT, () => clearTimeout(fallback));
+                    this.cp = null;
+                }
+                if (!this.fileStream) {
+                    resolve();
+                    return;
+                }
+                const stream = this.fileStream;
+                this.fileStream = null;
+                let resolved = false;
+                const done = () => {
+                    if (resolved)
+                        return;
+                    resolved = true;
+                    resolve();
+                };
+                stream.on(StreamEvent.FINISH, done);
+                stream.on(StreamEvent.CLOSE, done);
+                stream.on(StreamEvent.ERROR, done);
+                setTimeout(done, 1500);
+            }, 500);
+        });
+    }
+    getFilepath() {
+        return this.filepath;
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/audio/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/audio/recorder.ts"],"names":[],"mappings":"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"}

package/dist/components/App.d.ts

@@ -0,0 +1,5 @@
+import { type AppConfig } from '../config/configManager.js';
+export declare function App({ appConfig }: {
+    appConfig: AppConfig;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=App.d.ts.map

package/dist/components/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/components/App.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,4BAA4B,CAAC;AAsE3E,wBAAgB,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,2CA0V1D"}