받아쓰기

말하는 사람을 구분해 실시간으로 받아 적는, 가볍고 빠른 Windows 회의 전사 앱

러스트(Rust)로 만들어 가볍고, 로컬 AI(whisper.cpp)로 인터넷 없이도 동작합니다. 트레이에서 한 번 누르면 시작 — 회의에만 집중하세요.

🌐 홈페이지 · ⬇️ 내려받기 · 버그 제보

화면 예시 (데모 데이터)

---

✨ 특징

🎙️ 화자 자동 구분	발화마다 목소리 임베딩(3D-Speaker CAM++)을 뽑아 실시간으로 사람을 나눕니다. 쉼 없이 말을 이어받아도 문장 안의 화자 전환점을 찾아 쪼갭니다. 이름을 눌러 "화자 1" → "김 팀장"으로 바로 변경하고, 잘못 나뉜 화자는 합치기 · 문단별로 화자 바꾸기로 정리.
🇰🇷 한국어에 강한 인식	Whisper large-v3 turbo. 용어집에 회사·제품명을 넣으면 고유명사 인식률이 올라갑니다. "시청해 주셔서 감사합니다" 같은 Whisper 특유의 환각 문구와 반복 루프를 걸러냅니다.
🔒 로컬 또는 API	민감한 회의는 PC 안에서만(whisper.cpp). 빠르게 필요하면 Groq · OpenAI · OpenAI 호환 서버. 화자 구분은 어떤 엔진이든 항상 로컬에서 처리합니다.
⚡ 실시간	Silero VAD로 말이 멈추는 순간 발화를 잘라 바로 인식합니다. 짧은 발화는 인코더 창을 줄여 3~5배 빠르게.
🖱️ 트레이 원클릭 · 미니 창	창을 닫아도 트레이에 상주. 전역 단축키 Ctrl+Alt+R 로 어디서든 녹음 시작/중지. 미니 창은 녹음 버튼과 방금 받아 적은 한 줄만 작업 표시줄 시계 위에 띄워 둡니다. 창을 끌면 화면 가장자리·작업 표시줄에 자석처럼 붙어요.
💻 온라인 회의	마이크 + PC 소리(WASAPI 루프백) 동시 캡처 — Zoom · Teams · Meet 상대방 목소리까지. 가상 오디오 장치 불필요.
✍️ AI 회의록 요약	한 줄 요약 · 주요 논의 · 결정 사항 · 할 일(담당자/기한) + 회의 제목 자동 작성. Groq · Gemini(무료 등급) · Claude · OpenAI · 로컬 LLM(Ollama, 한국어 특화 EXAONE 3.5) · OpenAI 호환 서버.
🎧 다시 듣기 · 문장 눌러 듣기	회의 녹음을 앱 안에서 바로 재생(속도 0.75~2배) — 녹음 중에도 앞부분을 다시 들을 수 있어요. 문장을 누르면 그 부분만 들려주고, 이어 들으면 지금 문장을 따라가며 표시합니다.
📂 녹음 파일 받아쓰기	휴대폰·Zoom 녹음(mp3 · m4a · mp4 · wav · flac · ogg · opus)을 창에 끌어다 놓으면 화자를 나눠 받아 적습니다.
💾 자동 저장 · 찾기 · 내보내기	말하는 동안 계속 저장(앱이 꺼져도 안전). 지난 회의 전체 검색, 녹취록 안 Ctrl+F 찾기. 더블클릭으로 오타 수정(비우면 삭제). Markdown · TXT · SRT 자막 · JSON.
🔄 자동 업데이트	새 버전을 백그라운드에서 받아 두었다가, 쓰지 않을 때(트레이에 있을 때) 조용히 적용합니다. 서명(minisign)을 검증한 파일만 설치.

⬇️ 설치

1. Releases에서 Badasugi_x.y.z_x64-setup.exe 를 내려받아 실행합니다. (관리자 권한 불필요)
2. 처음 실행하면 모델 내려받기 버튼이 보입니다 → 음성 인식 모델(약 574MB) + 화자 모델(28MB)을 한 번만 받으면 이후 오프라인으로 동작합니다.
   • 모델을 받기 싫다면 설정에서 Groq / OpenAI 를 고르고 API 키만 넣으면 바로 쓸 수 있습니다.
3. 녹음 버튼(또는 Ctrl+Alt+R)을 누르고 회의를 시작하세요.

"Windows의 PC 보호" 경고가 뜨면 — 코드 서명 인증서가 없는 개인 오픈소스라 SmartScreen이 경고합니다. 추가 정보 → 실행 을 누르세요. 걱정되면 직접 빌드할 수 있습니다.

요구 사항: Windows 10/11 64비트, AVX2 지원 CPU(2013년 이후 대부분), WebView2(Windows 11 기본 포함). GPU 불필요.

🚀 사용법

하고 싶은 것	방법
녹음 시작/중지	녹음 버튼 · Ctrl+Alt+R · 트레이 아이콘 우클릭
미니 창 (작업 표시줄 시계 위)	상단 ▣ 버튼 · 제목 줄 더블클릭 · 트레이 메뉴 미니 창으로 — 미니 창을 더블클릭(또는 ⤢)하면 원래 창 위치·크기로 복구
잠깐 멈추기 (오프 더 레코드)	녹음 중 하단 ⏸ · 트레이 메뉴 일시정지
녹음 파일 받아쓰기	파일을 창에 끌어다 놓기 · 회의 기록 › 📄
입력 소리 바꾸기	하단 마이크 ▾ → 마이크 / 시스템 소리 / 마이크 + 시스템
화자 이름 바꾸기 · 합치기	상단 화자 칩 클릭 → 이름 바꾸기 / 다른 화자와 합치기
한 문단의 화자만 바꾸기	본문의 화자 이름 클릭 → 다른 화자 / 새 화자로 나누기
그 부분 다시 듣기	문장을 한 번 클릭 (녹음 파일 저장을 켰거나, 파일로 받아 적은 기록) · 위쪽 재생 막대 · Space
잘못 들린 단어 고치기	문장을 더블클릭 → 수정 → Enter (내용을 비우면 삭제)
녹취록에서 찾기	Ctrl+F (Enter 다음 · Shift+Enter 이전)
글자 크게/작게	Ctrl + + / - / 0 또는 Ctrl + 휠
회의 요약	하단 ✨ 버튼 (설정 › AI 요약에서 제공자 선택)
내보내기	하단 ⬇ 버튼 → Markdown / TXT / SRT / JSON
지난 회의 보기 · 검색	상단 🕘 회의 기록 → 위쪽 검색 칸 (제목·내용)
회의 화면 옆에 띄워두기	상단 📌 항상 위

명령줄 제어 (Stream Deck · 배치 파일 · 바로 가기)

이미 실행 중인 받아쓰기에 명령이 전달됩니다.

badasugi.exe --toggle   :: 녹음 시작/중지
badasugi.exe --start
badasugi.exe --stop
badasugi.exe --pause  :: 일시정지/이어서
badasugi.exe --mini   :: 미니 창 ↔ 원래 창
badasugi.exe 회의.m4a :: 녹음 파일 받아쓰기

화자 구분이 어긋날 때

• 이미 받아 적은 기록은 화자 칩 → 다른 화자와 합치기, 본문 화자 이름 → 이 문단의 화자를 바꾸기로 바로 고칠 수 있습니다. 녹음 중에 합치면 앞으로 들어오는 발화도 함께 합쳐집니다.
• 한 사람이 여러 명으로 나뉘면 → 설정 › 화자 구분 › 구분 민감도를 왼쪽(화자를 적게)으로
• 여러 사람이 한 명으로 합쳐지면 → 오른쪽(화자를 많이)으로
• 참석 인원을 알면 최대 화자 수를 지정하는 게 가장 정확합니다.

⚙️ 엔진 고르기

	로컬 (whisper.cpp)	Groq	OpenAI
모델	large-v3-turbo (q5) 등	whisper-large-v3-turbo	gpt-4o-transcribe
속도	PC 사양에 따라	매우 빠름	빠름
한국어 정확도	높음	높음	매우 높음
비용	무료	사용량 과금 (저렴)	사용량 과금
회의 내용	PC 밖으로 안 나감	Groq 서버로 전송	OpenAI 서버로 전송

• 사용자 지정: OpenAI 호환 /audio/transcriptions 서버(faster-whisper-server, LocalAI, 사내 서버 등)를 연결할 수 있습니다.
• API 키는 Windows 자격 증명 관리자에 저장됩니다(설정 파일에 평문으로 남지 않음).
• 모델 폴더(%LOCALAPPDATA%\com.badasugi.desktop\models)에 ggml-*.bin 을 직접 넣으면 목록에 나타납니다(한국어 파인튜닝 모델 등).

성능 메모 (솔직하게)

로컬 엔진 속도는 CPU에 크게 좌우됩니다. 개발 PC(Intel Core 5 210H, 8코어, GPU 미사용) 측정값:

모델	8.3초 발화 처리	비고
large-v3-turbo q5 (인코더 창 축소 적용)	약 4.8초	짧은 발화는 발화당 약 5~6초
large-v3-turbo q5 (기본 30초 창)	약 25초	← 받아쓰기가 피하는 방식
base q5	약 1.2초	빠르지만 한국어 정확도 낮음

말이 끊임없이 이어지는 회의에서 CPU가 느리면 인식이 조금씩 밀릴 수 있습니다(앱이 알려줍니다). 그럴 땐 Groq API(초 단위 응답, 저렴)나 가벼운 모델을 권장합니다. GPU 가속(Vulkan) 빌드는 아래 "직접 빌드하기"를 참고하세요.

✍️ AI 요약 고르기

요약은 앱에 LLM을 넣지 않고(가볍게 유지), 아래 중 하나에 연결합니다. 설정 › AI 요약에서 고른 뒤 연결 확인 · 모델 목록 불러오기를 누르면 키 확인과 모델 목록이 한 번에 됩니다.

제공자	특징	키
Groq	무료 등급 · 매우 빠름 (기본 openai/gpt-oss-120b)	음성 인식 Groq 키를 같이 씀
Gemini	무료 등급 · 한국어 품질 좋음 (기본 gemini-flash-latest)	AI Studio
Claude	긴 회의도 꼼꼼하게 (claude-opus-5-5)	Anthropic 콘솔
OpenAI	gpt-5-mini	음성 인식 OpenAI 키를 같이 씀
Ollama	PC 안에서만 (인터넷 불필요). Ollama 설치 + ollama pull exaone3.5:7.8b 필요	없음
사용자 지정	LM Studio · vLLM · OpenRouter 등 OpenAI 호환 서버	선택

API를 쓰면 녹취록이 해당 서비스로 전송됩니다. 회의 내용이 밖으로 나가면 안 되면 Ollama를 쓰세요.

This is the beginning of the README. Read the rest at the original. Read the full README ↗