단축키 누르기 → 말하기 → 텍스트 획득. 무료이며 오픈 소스입니다 ❤️

Whispering은 오픈 소스 음성-텍스트 변환 (Speech-to-Text) 애플리케이션입니다. 키보드 단축키를 누르고 말을 하면, 당신의 말이 전사(transcribe) 및 변환(transform)된 후 커서 위치에 복사 및 붙여넣기 됩니다.

저는 핸즈프리 음성 받아쓰기 (hands-free voice dictation)를 정말 좋아합니다. 수년 동안 저는 '거의' 괜찮은 수준의 전사 도구들에 의존해 왔지만

시중에는 각기 다른 강점을 가진 수많은 전사 (transcription) 앱들이 있습니다. Whispering은 진정한 핸즈프리 작동을 위한 음성 활성화 모드(버튼을 누를 필요 없음)와 어떤 프롬프트/모델로도 가능한 맞춤형 AI 변환 기능과 같은 몇 가지 특별한 기능들을 갖추고 있습니다. 이 분야는 훌륭한 아이디어들로 가득 차 있지만, 저는 오픈 소스 (OSS) 생태계로부터 추가적인 경쟁력을 더하고 싶었을 뿐입니다.

Svelte 5와 Tauri로 구축되어 크기가 매우 작고 (~22MB) 즉시 실행됩니다. 코드베이스는 문서화가 잘 되어 있으며, 이해하고 감사 (audit)할 수 있도록 설계되었습니다. 이를 통해 여러분의 오디오가 어디로 가는지, 어떻게 처리되는지, 그리고 어떤 데이터가 저장되는지 알 수 있습니다. 마지막으로 비용 절감 효과입니다. 중간 단계를 제거하면 제공업체에 직접 비용을 지불하게 됩니다:

우리는 오픈 소스 및 로컬 우선 (local-first) 커뮤니티가 함께 힘을 모아 그 어떤 폐쇄형 소스 (closed-source) 대안보다 더 나은 것을 만들 수 있기를 희망합니다. 근본적인 도구들은 블랙박스 (black box)를 신뢰할 필요가 없어야 한다고 믿기 때문에 코드는 오픈 소스로 공개되었습니다. 기업은 사업 방향을 바꾸거나, 인수되거나, 폐업할 수 있습니다. 하지만 오픈 소스는 영원합니다. ❤️

Whispering을 설정하고 약 2분 안에 전사를 시작할 준비를 마치세요.

🍎 macOS

macOS에서 Whispering을 설치하는 가장 빠른 방법:

brew install --cask whispering

이 명령은 설치와 업데이트를 자동으로 처리합니다.

💡 팁: 사용 중인 Mac의 종류를 모르시나요? Apple 메뉴 → 이 Mac에 관하여(About This Mac)를 클릭하세요. "칩(Chip)" 또는 "프로세서(Processor)" 항목을 확인하세요:

• Apple M1/M2/M3/M4 → Apple Silicon 버전을 사용하세요
• Intel Core → Intel 버전을 사용하세요

설치 단계:

• 사용 중인 아키텍처(architecture)에 맞는 .dmg 파일을 다운로드합니다.
• 다운로드한 파일을 엽니다.
• Whispering을 응용 프로그램(Applications) 폴더로 드래그합니다.
• 응용 프로그램에서 Whispering을 실행합니다.

"확인되지 않은 개발자(Unverified developer)" 경고: 앱을 우클릭 → 열기 → 열기를 선택합니다.

"앱이 손상되었습니다(App is damaged)" 오류 (Apple Silicon):
터미널(Terminal)에서 xattr -cr /Applications/Whispering.app 명령어를 실행하세요.

🪟 Windows

• .msi 설치 프로그램(권장)을 다운로드합니다.
• 설치 프로그램을 실행하기 위해 더블 클릭합니다.
• Windows Defender가 나타나는 경우: "추가 정보(More Info)" → "실행(Run Anyway)"를 클릭합니다.
• 설치 마법사(installation wizard)를 따릅니다.

설치가 완료되면 시작 메뉴(Start Menu)에 Whispering이 나타납니다.

🐧 Linux

AppImage (범용)

wget https://github.com/EpicenterHQ/epicenter/releases/download/v7.11.0/Whispering_7.11.0_amd64.AppImage
chmod +x Whispering_7.11.0_amd64.AppImage
./Whispering_7.11.0_amd64.AppImage

Debian/Ubuntu

wget https://github.com/EpicenterHQ/epicenter/releases/download/v7.11.0/Whispering_7.11.0_amd64.deb
sudo dpkg -i Whispering_7.11.0_amd64.deb

Fedora/RHEL

wget https://github.com/EpicenterHQ/epicenter/releases/download/v7.11.0/Whispering-7.11.0-1.x86_64.rpm
sudo rpm -i Whispering-7.11.0-1.x86_64.rpm

브라우저에서 체험하기 (다운로드 불필요)

설치가 필요 없습니다! 모든 최신 브라우저에서 작동합니다.

📝 참고: 웹 버전은 전역 키보드 단축키(global keyboard shortcuts)를 지원하지 않지만, 그 외에는 설치 전 Whispering을 체험해 보기에 매우 좋습니다.

Whispering은 두 가지 전사 (transcription) 방식을 제공합니다. 귀하의 필요에 맞는 방식을 선택하세요:

🏠 옵션 A: 로컬 전사 (Whisper C++)

최적의 용도: 완전한 개인정보 보호, 오프라인 사용, 추가 비용 없음

오디오 데이터가 기기를 절대 벗어나지 않습니다. 인터넷 없이도 작동하며, 영구적으로 무료입니다.

먼저, 모델을 다운로드해야 합니다 (필수):

• Whispering을 엽니다.
• 설정 (Settings) (⚙️) → **전사 (Transcription)**를 클릭합니다.
• 드롭다운 메뉴에서 **Whisper C++**를 선택합니다.
• 모델을 선택합니다 (속도와 정확도의 균형이 좋은 Small 모델로 시작하는 것을 권장합니다).
• 모델 옆의 다운로드 (Download) 버튼을 클릭합니다.
• 다운로드가 완료될 때까지 기다립니다 (몇 분 정도 걸릴 수 있습니다).
• 모델이 활성화 (activated) 상태로 표시되는지 확인합니다.

전사를 시작하기 전에 반드시 모델을 다운로드해야 합니다.

⚠️ 중요:

• 녹음 버튼을 클릭하거나 키보드 단축키를 사용하세요.
• "Testing local transcription"이라고 말합니다.
• 녹음 중지 버튼을 누르고 처리가 완료될 때까지 기다립니다.

🎉 성공! 이제 귀하의 말이 클립보드에 저장되었습니다. 어디든 붙여넣으세요!

📝 참고: 로컬 전사는 클라우드 옵션보다 느리지만 완전한 개인정보 보호를 제공합니다. 처리 속도는 하드웨어 성능과 선택한 모델의 크기에 따라 달라집니다.

☁️ 옵션 B: 클라우드 전사 (Groq)

최적의 용도: 빠른 설정, 즉각적인 결과, 높은 정확도

저는 개인적으로 대부분의 전사에 Groq를 사용합니다. 믿기지 않을 정도로 빠르고 정확하기 때문입니다.

💡 팁: 왜 Groq인가요? 가장 빠른 전사 모델, 매우 높은 정확도, 관대한 무료 티어(free tier), 그리고 타의 추종을 불허하는 가격(whisper-large-v3-turbo 사용 시 시간당 $0.04 수준)을 제공합니다.

• console.groq.com/keys 에 방문합니다.

• 가입합니다 (무료, 신용카드 불필요) → API 키를 생성합니다 → 키를 복사합니다.

• Whispering을 엽니다.

• 설정 (Settings) (⚙️) → **전사 (Transcription)**를 클릭합니다.

• 드롭다운 메뉴에서 Groq를 선택합니다.

• API 키 필드에 복사한 API 키를 붙여넣습니다.

• 모델을 선택합니다 (whisper-large-v3-turbo가 가장 빠르고 저렴합니다).

• 녹음 버튼을 클릭하거나 키보드 단축키를 사용합니다.

• "Testing cloud transcription"이라고 말합니다.

• 결과가 거의 즉시 나타납니다.

🎉 성공! 이제 당신의 말이 클립보드에 복사되었습니다. 어디든 붙여넣으세요!

📝 참고: 클라우드 전사 (Cloud transcription)는 인터넷 연결이 필요하며 오디오를 Groq의 서버로 전송합니다. 귀하의 API 키는 중간 매개체 없이 데이터가 귀하로부터 Groq로 직접 전달되도록 보장합니다.

문제가 발생했나요? 일반적인 문제 및 해결 방법

전사가 되지 않나요? → 설정 (Settings)에서 API 키를 다시 확인하세요.
단축키가 작동하지 않나요? → Whispering을 전면(foreground)으로 가져오세요 (아래 macOS 섹션 참조).
잘못된 제공자(provider)가 선택되었나요? → 설정 (Settings) → 전사 (Transcription)를 확인하세요.

macOS: 전역 단축키가 작동을 멈추나요?

이는 배터리 절약을 위해 백그라운드 앱을 일시 중단하는 macOS의 앱 냅 (App Nap) 기능 때문에 발생합니다.

빠른 해결 방법:

• 핸즈프리 작동을 위해 음성 활성화 (Voice Activated) 모드를 사용하세요 (권장).
• 단축키를 복구하려면 Whispering을 잠시 전면 (foreground)으로 가져오세요.
• 앱 창을 전면 (foreground)에 유지하세요 (작은 창 형태라도 상관없습니다).

권장 사항: Whispering을 다른 앱들보다 앞쪽 전면 (foreground)에 두는 것이 가장 좋습니다. 창 크기를 작게 조절하거나, 방해를 최소화하기 위해 음성 활성화 (Voice Activated) 모드를 사용할 수 있습니다.

실수로 마이크 권한을 거부했나요?

Whispering이 마이크 액세스를 요청했을 때 실수로 "허용 안 함"을 클릭했다면, 다음과 같이 해결할 수 있습니다:

• 시스템 설정 (System Settings) → 개인정보 보호 및 보안 (Privacy & Security) → 개인정보 보호 (Privacy) → **마이크 (Microphone)**를 엽니다. - 목록에서 Whispering을 찾아 마이크 액세스를 활성화하도록 스위치를 켭니다.
• 만약 목록에 Whispering이 없다면, 앱을 재설치하여 권한 요청 프롬프트가 다시 뜨도록 합니다.

실수로 마이크 권한을 차단했다면, 레지스트리 (Registry) 해결 방법을 사용하세요:

레지스트리 정리 (권장)

• Whispering을 종료합니다.
• 레지스트리 편집기 (Registry Editor)를 엽니다 (Win+R을 누르고 regedit 입력).
• 찾기 (Ctrl+F)를 사용하여 "Whispering"을 검색합니다.
• "Whispering"이 포함된 모든 레지스트리 폴더를 삭제합니다.
• F3을 눌러 다음 항목을 찾고, 모든 항목이 제거될 때까지 반복합니다.
• Whispering을 삭제 후 재설치합니다.
• 요청 시 권한을 수락합니다.

대안 해결책

앱 데이터 삭제 (Delete App Data): %APPDATA%\..\Local\com.bradenwong.whispering 경로로 이동하여

이 폴더를 삭제한 후 재설치하십시오.

Windows 설정 (Windows Settings): 설정 → 개인 정보 및 보안 → 마이크 → "데스크톱 앱이 마이크에 액세스하도록 허용" 활성화

자세한 내용은 Issue #526을 참조하십시오.

다음의 고급 기능들을 통해 받아쓰기 경험을 한 단계 더 높여보세요:

🎯 맞춤형 받아쓰기 서비스 (Custom Transcription Services)

속도, 정확도 및 개인정보 보호 요구 사항에 따라 다양한 받아쓰기 제공업체 중에서 선택할 수 있습니다:

Groq

• API 키 (API Key): console.groq.com/keys
• 모델 (Models): whisper-large-v3-turbo ($0.04/hr), whisper-large-v3 ($0.111/hr)
• 이유 (Why): 가장 빠르고 저렴하며, 관대한 무료 티어(Free tier)를 제공함

OpenAI

• API 키 (API Key): platform.openai.com/api-keys (결제 활성화 필요)
• 모델 (Models): whisper-1 ($0.36/hr), gpt-4o-transcribe ($0.36/hr), gpt-4o-mini-transcribe ($0.18/hr)
• 이유 (Why): 업계 표준

ElevenLabs

• API 키 (API Key): elevenlabs.io/app/settings/api-keys
• 모델 (Models): scribe_v2, scribe_v1, scribe_v1_experimental
• 이유 (Why): 고품질 음성 AI

Local (로컬)

• API 키 (API Key): 필요 없음!
• 이유 (Why): 완전한 개인정보 보호, 오프라인 사용, 영구 무료

🤖 AI 기반 변환 (AI-Powered Transformations)

맞춤형 AI 워크플로 (Workflows)를 통해 받아쓰기 텍스트를 자동으로 변환하십시오:

빠른 예시: 텍스트 서식 지정 (Format Text)

• 상단 바에서 변환 (Transformations) (📚) 메뉴로 이동합니다. - "Create Transformation"을 클릭한 후 이름을 "Format Text"로 지정합니다.

• 프롬프트 변환 (Prompt Transform) 단계를 추가합니다:

  • 모델 (Model): Claude Sonnet 3.5 (또는 선호하는 AI)
  • 시스템 프롬프트 (System prompt): `당신은 받아쓰기된 음성을 정리하는 데 특화된 지능형 텍스트 서식 지정 전문가입니다. 당신의 임무는 원본 받아쓰기 텍스트를 화자의 원래 의도와 목소리를 유지하면서 잘 정돈된 읽기 쉬운 콘텐츠로 변환하는 것입니다.

• 모델 (Model):

핵심 원칙 (Core Principles):

• 진정성 유지 (Preserve authenticity): 가능한 한 원래의 단어와 표현을 유지하십시오.
• 명확성 추가 (Add clarity): 이해를 위해 필요한 경우에만 지능적인 수정을 수행하십시오.
• 가독성 향상 (Enhance readability): 적절한 서식, 구두점 및 구조를 적용하십시오.

서식 가이드라인 (Formatting Guidelines):

구두점 및 문법 (Punctuation & Grammar):

• 적절한 구두점(마침표, 쉼표, 물음표) 추가
• 화자의 말하기 스타일을 유지하면서 명백한 전사 오류(transcription errors) 수정
• 자연스러운 끊어 읽기를 추가하여 만연체 문장(run-on sentences) 수정
• 대화체 톤과 개인적인 말하기 패턴 유지

구조 및 구성 (Structure & Organization):

• 주제가 자연스럽게 전환되는 지점에 문단 나누기 적용
• 화자가 항목을 나열할 때 글머리 기호(bullet points) 또는 번호 매기기 목록 사용
• 콘텐츠에 명확한 섹션이 있는 경우 제목(headings) 추가
• 화자가 단어를 강조할 때 이탤릭체나 굵게(bold)를 사용하여 강조 유지

지능형 수정 (Intelligent Corrections):

• 동음이의어 수정 (예: "there/their/they're")
• 의도가 명확한 경우 중단된 생각 완성하기
• 의미를 더하지 않는 과도한 채움말(filler words, 예: um, uh) 제거
• 명백한 실수를 수정하되, 중요한 실수는 [대괄호] 안에 기록

특별 처리 (Special Handling):