opennookorg/betterwispr

BetterWispr – macOS용 오프라인 음성 받아쓰기

개요 – BetterWispr는 무료 오픈소스 macOS 애플리케이션으로, 키보드 단축키(기본값 ⌥ Space)를 누르고 있는 동안 어떤 창에든 텍스트를 받아쓰게 할 수 있습니다. 완전히 컴퓨터에서 실행되며, 온디바이스 음성 모델(Apple 내장 인식기, NVIDIA Parakeet, OpenAI의 Whisper)을 사용하므로 외부 API를 명시적으로 연결하지 않는 한 음성이 기기를 떠나지 않습니다.

주요 기능

• 길게 눌러 말하기 또는 토글 말하기 – 단축키를 누르고 말한 뒤 놓으면 커서가 있는 곳에 전사된 텍스트가 붙여넣어집니다.
• 온디바이스 모델 – Apple Speech(다운로드 불필요), Parakeet v2/v3(유럽 25개 언어), Whisper large-v3 turbo. 모두 한 번 다운로드하면 오프라인으로 실행됩니다.
• 사용자 정의 어휘 – 이름, 전문 용어 등에 대한 철자 힌트와 문구 대체를 추가할 수 있습니다.
• 수정에서 학습 – 잘못 들은 단어를 한 번 수정하면(기록 또는 붙여넣기 직후) 다음에 올바르게 철자하도록 앱에 학습시킵니다.
• 음성 명령 – 받아쓰는 동안 "쉼표", "새 줄", "그거 취소", "미안, 그거 삭제", "앳 마크 KV"(→ "@KV")라고 말하여 구두점이나 기호를 삽입할 수 있습니다.
• 회의 모드 – 대화 양측의 실시간 전사. Apple Intelligence 또는 로컬 Ollama 모델을 사용하는 온디바이스 제목, 요약, 실행 항목 추출(선택 사항)을 지원합니다.
• 기록 – 원본 및 수정된 전사가 로컬에 저장되며(비활성화 가능), 검토하거나 재사용할 수 있습니다.
• 모델 가져오기 – OpenAI 호환 엔드포인트(예: Sarvam AI, Smallest AI, 자체 호스팅 서버)에 연결할 수 있습니다. 키는 macOS 키체인에 보관되며 오디오는 선택한 엔드포인트로만 전송됩니다.

개인정보 및 데이터 처리

• 설정, 사용자 정의 어휘, 전사 기록은 ~/Library/Application Support/BetterWispr/workspace.json(일반 JSON, 암호화되지 않음)에 저장됩니다.
• 모델 파일은 같은 수준의 Models 폴더에 저장됩니다.
• 오디오 녹음은 임시 파일에 작성되며 각 받아쓰기 직후 삭제됩니다.
• 내장 모델은 명시적으로 다운로드하지 않는 한 인터넷에 연결하지 않습니다. 외부 모델 연결은 사용자가 활성화할 때만 사용됩니다.

시작하기

1. 최신 릴리스에서 DMG를 다운로드하고 BetterWispr를 응용 프로그램 폴더로 끌어다 놓습니다.
2. 앱을 열고 환영 가이드를 따라 모델에서 모델을 선택합니다.
3. 마이크 및 손쉬운 사용 권한을 부여합니다(후자는 앱이 텍스트를 붙여넣을 수 있게 합니다).
4. 아무 텍스트 필드나 클릭하고 ⌥ Space를 누른 상태에서 말한 후 놓습니다.
   • 붙여넣기가 실패하면 텍스트가 대체로 클립보드에 복사됩니다.
   • 녹음은 2분 후 자동으로 중지됩니다.

시스템 요구 사항 – macOS 14 이상(Apple Silicon 권장).

기여 – 빌드 지침, 프로젝트 구조, 기여 지침은 CONTRIBUTING.md에 있습니다.

라이선스 – Apache-2.0(타사 모델 가중치는 각각의 라이선스를 유지합니다).