transcribe

1# Transcribe
2 
3Local speech-to-text using `parakeet-cpp-transcribe` on Apple Silicon macOS.
4 
5## Usage
6 
7```bash
8{baseDir}/transcribe.sh <audio-file>
9```
10 
11The first run downloads the macOS arm64 binary from the latest `badlogic/pibot` GitHub release into the extension's ignored `bin` directory:
12 
13```text
14{extensionDir}/bin/parakeet-cpp-transcribe
15```
16 
17(`{extensionDir}` is the parent directory of this skill's `{baseDir}`.) The binary downloads its GGUF model automatically if missing.
18 
19## Output
20 
21Plain text timestamped in 15 second chunks is written to stdout:
22 
23```text
24[00:00-00:15] transcript text
25[00:15-00:30] more transcript text
26```
27 
28Model/GGML diagnostic logs are written to stderr. Redirect stderr to hide them:
29 
30```bash
31{baseDir}/transcribe.sh <audio-file> 2>/dev/null
32```
33 
34## Requirements
35 
36- Apple Silicon macOS only
37- `curl` and `tar`
38- `ffmpeg` for non-WAV input: `brew install ffmpeg`