Skip to content

earpop-cli 0.2.0

Choose a tag to compare

@e2goon e2goon released this 24 Aug 05:59
· 34 commits to main since this release

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_BIN or EARPOP_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.0

npm 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