Repository navigation
Highlights
- Live translation. Pick one language in settings ("Translation") to translate everything into it, or two to translate between them. Translated lines appear in italics under the speech they translate and are saved in the transcript. For one run:
earpop --translate koorearpop --translate en,es. - Built for mixed-language conversations. Every line shows its detected language when more than one is in play, such as
[S1 ja], and a new line starts when the language changes. Presslto show one language at a time. - Captions that read better in every script. Lines now end at sentence boundaries in Latin, CJK, Hindi, Arabic, and Urdu text, after a pause of more than two seconds, and when the speaker or language changes. Japanese, Chinese, and Thai wrap between words, and a speaker tag is never left alone on a row.
- Captions fill the terminal. A taller window shows more of the conversation, and settings, the microphone list, and the new
?key help open below the captions instead of hiding them. - Subtitle and Markdown exports.
earpop transcripts export <id> --format srt|vtt|md, with--outfor the path andlatestfor the newest transcript. Subtitle cues end at sentences, and translations appear at the same time as the speech. - Terms.
earpop terms add "Kold Brew" Kubernetesteaches Soniox how to spell names and jargon. - Languages on first run. earpop asks which languages people will speak instead of assuming the system language.
--lang ja,enoverrides them for one run, the language picker is searchable, andearpop languageslists every code. - Bluetooth microphones and hearing aids. If a microphone stops sending audio, as Bluetooth devices do when they switch to their microphone mode, earpop reopens it within a few seconds instead of showing "Listening" with no captions.
- Soniox stt-rt-v6. The newest model, with better accuracy across languages. stt-rt-v5 is retired by Soniox on 2026-12-15.
Changes
earpop transcripts listshows each transcript's length instead of its token count, and reads only the start and end of each file.- Pausing no longer copies the transcript path to the clipboard. Press
cto copy it. - The key hint line keeps the most important keys on narrow terminals;
?lists them all. Shortcuts also accept Korean jamo typed in Hangul mode. - The status line shows the languages in use and any translation.
- On Linux, the microphone list hides ALSA's converter and routing plugins and shows the default input as "System default". Microphones saved under the old name still work.
- Speaker colors no longer use white or dark blue, which disappeared on light or dark themes.
earpop --versionprints the version.- In our tests, provisional captions arrive about 0.3 seconds later with stt-rt-v6 than with v5.
Fixes
- Sentences ending in a period now start a new line; before, a line ran on until the speaker changed.
ESCworks on the region, API key, and first microphone screens; the key screen's ESC goes back to region selection.- A saved microphone that is no longer connected no longer hides the microphone list on first run.
- Settings and microphone menus fit short terminals.
- Losing the microphone closes the Soniox session until you pick another one, so no idle session stays open.
- The capture helper exits when earpop is killed, so the microphone is never left open.
- Errors that a reconnect cannot fix (bad request, key, balance, or permission) stop instead of retrying forever.
- A transcript that cannot be saved shows a warning on screen and at exit.
- Failed settings saves show a message instead of crashing.
Ctrl+Cno longer also triggers the copy shortcut.
Under the hood
- Sends the Soniox API key in the
Authorizationheader; the start-requestapi_keyfield is deprecated. - The published CLI runs React and Ink in production mode, which uses less memory on every caption update.
- Updated ws (includes a security fix), oxlint, oxfmt, and Rust crates; the
rules-of-hookslint rule is on. - Unit tests (
pnpm test) and a CI check for every pull request. - macOS capture helpers now build on
macos-15.
Install
npm i -g earpop-cli@0.4.0Platform capture packages (earpop-capture-*) are published as matching optional dependencies.
Full changelog: v0.3.0...v0.4.0