Repository navigation
earpop-cli 0.2.0
earpop-cli 0.2.0
Live STT capture no longer depends on ffmpeg. Mic listing and streaming use a native cpal + rubato sidecar, shipped per platform via npm optional dependencies.
Highlights
- Native capture sidecar —
earpop-capture(cpal + rubato) streams 16 kHz mono PCM; no ffmpeg on the live path - Cross-platform packages — optional deps for darwin-arm64 / darwin-x64 / win32-x64 / linux-x64 / linux-arm64
- Integrity checks — SHA-256 verification of capture binaries (override with
EARPOP_CAPTURE_BINorEARPOP_SKIP_CAPTURE_INTEGRITY=1) - STT defaults — Soniox realtime with Korean/English language hints and diarization
- Node.js 24+ — engines and build target aligned to Active LTS
- UX — Esc quit shortcut fixed
Install
npm i -g earpop-cli@0.2.0
# or
npx earpop-cli@0.2.0npm installs only the capture binary that matches your OS/arch.
Requirements
- Node.js 24+
- Soniox API key (region must match CLI:
us/eu/jp) - Supported OS for live mic: macOS, Windows, Linux (ALSA on Linux)
Breaking / migration
- ffmpeg is no longer used for live capture. If a previous setup relied on a system ffmpeg binary, it can be removed for earpop.
- Node < 24 is unsupported.
- First install on a new platform pulls the matching
earpop-capture-*optional package; if optional deps are skipped (--omit=optional), live mic will not work until that package (or a local build) is available.
Platform packages
| Package | Platform |
|---|---|
earpop-capture-darwin-arm64 |
macOS Apple Silicon |
earpop-capture-darwin-x64 |
macOS Intel |
earpop-capture-win32-x64 |
Windows x64 |
earpop-capture-linux-x64 |
Linux x64 |
earpop-capture-linux-arm64 |
Linux arm64 |
Env (new / relevant)
| Variable | Role |
|---|---|
EARPOP_CAPTURE_BIN |
Path to a custom capture binary (skips integrity) |
EARPOP_SKIP_CAPTURE_INTEGRITY |
1 to skip SHA-256 checks |