badlogic/pi-skills

transcribe

Local speech-to-text transcription on Apple Silicon macOS.

View source
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Transcribe

Local speech-to-text using parakeet-cpp-transcribe on Apple Silicon macOS.

Usage

bash
{baseDir}/transcribe.sh <audio-file>

The first run downloads the macOS arm64 binary from the latest badlogic/pibot GitHub release into the extension's ignored bin directory:

text
{extensionDir}/bin/parakeet-cpp-transcribe

({extensionDir} is the parent directory of this skill's {baseDir}.) The binary downloads its GGUF model automatically if missing.

Output

Plain text timestamped in 15 second chunks is written to stdout:

text
[00:00-00:15] transcript text
[00:15-00:30] more transcript text

Model/GGML diagnostic logs are written to stderr. Redirect stderr to hide them:

bash
{baseDir}/transcribe.sh <audio-file> 2>/dev/null

Requirements

  • Apple Silicon macOS only
  • curl and tar
  • ffmpeg for non-WAV input: brew install ffmpeg
from this repository

More skills

All skills