본문으로 이동

earpop-cli 0.4.0 출시: 회의 자막 실시간 번역과 자막 파일 내보내기

geul조회 9추천 0댓글 1

터미널 아래에 회의 자막을 띄워 두는 earpop-cli가 0.4.0으로 올라갔다. 11월 14일 출시.

  • 실시간 번역: 말하는 동안 바로 내가 고른 언어로 번역해 원문 아래 기울임꼴로 보여 줌

  • 여러 언어가 섞인 대화: 줄마다 어떤 언어인지 표시하고, 언어가 바뀌면 줄을 새로 시작함. l 키로 한 언어만 골라 볼 수 있음

  • 자막 파일로 내보내기: 회의 기록을 SRT, VTT 자막 파일이나 Markdown으로 저장함

  • 보청기, 블루투스 마이크 대응: 마이크가 소리를 보내지 않고 멈추면 몇 초 안에 다시 연결함

  • 음성 인식 모델을 Soniox 최신 버전(v6)으로 바꿈. 여러 언어에서 더 정확해짐

실시간 번역

설정에서 언어를 하나 고르면 모든 말을 그 언어로, 두 개 고르면 서로 번역함.

  • 한 언어: earpop --translate ko. 영어든 일본어든 들리는 말을 전부 한국어로 번역함

  • 두 언어: earpop --translate ko,en. 한국어는 영어로, 영어는 한국어로 번역함. 한국어와 영어를 섞어 쓰는 회의에 맞음

  • 번역은 원문 바로 아래 기울임꼴로 나오고, 기록 파일에도 함께 저장됨

  • 매번 옵션을 줄 필요 없이 설정 화면(s)의 Translation 항목에 저장해 둘 수 있음

위 GIF는 한국어 화자(S1)와 영어 화자(S2)의 회의를 --translate ko,en으로 받은 화면이다. 끝에 ?를 눌러 단축키 도움말을 띄웠다.

여러 언어가 섞인 대화

누가 어떤 언어로 말했는지 줄마다 표시함.

  • 두 언어 이상이 섞이면 [S1 ja]처럼 화자 번호 옆에 언어를 붙임

  • 같은 사람이 말하다가 언어를 바꾸면 줄을 새로 시작함

  • l을 누를 때마다 대화에 나온 언어를 하나씩 골라 보고, 마지막 언어 다음에는 전체 보기로 돌아감. 0을 누르면 바로 전체 보기

  • 위 GIF는 일본어, 영어, 한국어 세 사람의 대화를 --translate ko로 받은 뒤 l로 언어를 바꿔 본 장면이다

읽기 쉬워진 자막 줄 나눔

문장이 끝나는 곳에서 줄을 바꾸도록 손봄.

  • 마침표, 물음표 같은 문장 끝에서 새 줄을 시작함. 영어 같은 라틴 문자뿐 아니라 한중일 문자, 힌디어, 아랍어, 우르두어의 문장부호도 인식함

  • 2초 넘게 말이 끊기거나, 화자나 언어가 바뀔 때도 줄을 바꿈

  • 일본어, 중국어, 태국어는 단어 중간에서 끊기지 않게 줄을 넘김

  • 화자 표시만 한 줄에 덩그러니 남는 일이 없어짐

터미널을 꽉 채우는 화면

창을 키우면 그만큼 지난 대화를 더 보여 줌.

  • 설정, 마이크 목록, 새 ? 도움말이 자막을 가리지 않고 아래에 나옴

  • 창이 좁으면 자주 쓰는 단축키만 아래 안내줄에 남기고, 나머지는 ?로 확인함

  • 한글 입력 상태에서 l 자리의 ㅣ, s 자리의 ㄴ을 눌러도 단축키가 동작함

  • 상태줄에 지금 듣고 있는 언어와 번역 언어가 나옴

  • 화자 색에서 흰색과 짙은 파랑을 뺌. 밝은 테마, 어두운 테마에서 글자가 사라지던 문제임

자막 파일로 내보내기와 용어 등록

회의 기록을 영상 자막이나 문서로 바로 옮길 수 있음.

  • earpop transcripts export latest --format srt: 가장 최근 기록을 자막 파일로 저장. vtt, md, txt도 고를 수 있고 --out으로 저장 위치를 정함

  • 자막은 문장 단위로 끊기고, 번역은 원문과 같은 시간에 표시됨

  • Markdown으로 내보내면 그대로 AI 에이전트에 넣어 회의 요약을 맡기기 좋음

  • earpop terms add "Kold Brew" Kubernetes: 사람 이름, 제품명, 전문 용어를 등록하면 그 표기대로 받아 적음

  • earpop transcripts list는 기록마다 길이(시간)를 보여 주고, 기록이 많아도 빠르게 뜸

처음 실행할 때 언어를 물어봄

  • 시스템 언어를 그대로 쓰지 않고, 대화에 쓸 언어를 처음에 고르게 바꿈

  • 언어 목록에서 이름을 입력해 찾을 수 있음

  • 한 번만 다른 언어로 쓰고 싶으면 earpop --lang ja,en

  • 지원 언어 코드는 earpop languages로 확인

보청기, 블루투스 마이크

"듣는 중"이라고 떠 있는데 자막이 안 나오는 문제를 해결함.

  • 블루투스 기기는 마이크 모드로 바뀌는 순간 소리를 끊고 멈추는 경우가 있음

  • 이제 마이크가 몇 초 동안 소리를 보내지 않으면 earpop이 마이크를 다시 연결해 자막을 이어 감

  • 리눅스 마이크 목록에서 쓸 일 없는 장치를 숨기고, 기본 입력을 "System default"로 보여 줌

고친 버그

  • 마침표로 끝난 문장이 새 줄로 넘어가지 않고, 화자가 바뀔 때까지 한 줄로 이어지던 문제

  • 리전, API 키, 첫 마이크 선택 화면에서 ESC가 동작하지 않던 문제

  • 저장해 둔 마이크가 연결되지 않은 상태면 첫 실행 때 마이크 목록이 안 보이던 문제

  • 터미널 창이 낮으면 설정, 마이크 메뉴가 잘리던 문제

  • 마이크가 끊긴 뒤에도 Soniox 연결이 유지된 채 남던 문제. 다른 마이크를 고를 때까지 연결을 닫음

  • earpop을 강제로 끄면 마이크가 켜진 채 남던 문제

  • API 키 오류, 잔액 부족처럼 다시 연결해도 안 되는 오류를 끝없이 재시도하던 문제

  • 기록 파일을 저장하지 못해도 아무 표시가 없던 문제. 화면과 종료 시점에 경고를 띄움

  • 설정 저장에 실패하면 프로그램이 꺼지던 문제

  • Ctrl+C로 끌 때 복사 단축키까지 같이 실행되던 문제

달라진 사용법

  • 일시정지해도 기록 파일 경로를 클립보드에 복사하지 않음. 복사는 c

  • 잠정 자막(말하는 도중 먼저 뜨는 자막)이 이전 모델보다 조금 늦게 뜸. 대신 최종 결과가 더 정확함

  • 이전 모델(v5)은 Soniox가 12월 15일에 종료함

  • earpop --version으로 버전 확인

이렇게 쓰면 좋다

  • 외국인 동료와 하는 회의: earpop --translate ko,en으로 띄워 두면 상대 말은 한국어로, 내 말은 영어로 같이 보임

  • 일본어나 영어 강연, 설명회: earpop --translate ko로 전부 한국어로 받아 보기

  • 회의가 끝나면 earpop transcripts export latest --format md로 저장해 에이전트에 요약을 맡기기

  • 회의를 녹화하면서 earpop을 같이 켜 두면, 끝난 뒤 --format srt로 뽑아 영상 자막으로 붙일 수 있음

  • 팀 이름, 서비스 이름이 자꾸 틀리게 나오면 earpop terms add로 등록

설치와 업데이트

npm i -g earpop-cli@latest

Node.js 24 이상, macOS, Windows, Linux에서 동작한다. Soniox API 키가 필요하다. 처음 소개 글은 미팅 동안 터미널 밑에 띄워두는 라이브 캡션, earpop-cli에 있다.

GIF 속 대화는 합성 음성을 마이크 대신 넣고 실제 Soniox로 받아 적은 결과다.

0.4.0 릴리스 노트

추천저장

댓글 1

댓글을 남겨 보세요
로그인한 뒤에 댓글을 올릴 수 있습니다로그인
  • geul글쓴이수정됨

    이걸 만든 계기는 구독비 아끼기 위해서 였고 처음엔 회의록 요약을 위한 라이브캡션 전사로 출발. 이후 글로벌 리모트 근무 기회를 얻기 위해 라이브캡션 + 번역 도구의 필요성, 회의록 요약의 필요를 느껴서 이 같은 업데이트를 진행 함

    비용적으로 매월 20달러씩 지불해서 사용하던게 무거운 GUI프로그램 안쓰고 급하게 필요할 때마다 터미널을 띄워 라이브 전사 기능을 이용하니 편함

    API 종량제 5달러로 3달 넘게 사용중이고 아직 2달러 정도 남은 상태

글쓰기