파일 전사

설정 → 파일 전사는 Trial/Pro가 필요하며 Free Apple/로컬 엔진으로 해제되지 않습니다. 엔진 권한도 별도 검사합니다.

사용과 제한

파일 전용 모델을 선택/준비하고 공급자 키를 공유합니다. 오디오/비디오를 끌어 놓거나 가져오고 진행을 기다려 텍스트/자막 복사 또는 내보내기합니다. 로컬 기록에 저장하며 취소/재시도/삭제가 가능합니다.

확장자: mp3, wav, m4a, flac, opus, ogg, aac, aiff, aif, caf, mp4, mov, m4v, mkv, webm. 4 GiB, 디코딩 최대 4시간. macOS가 오디오 코덱을 읽어야 하고 확장자만으로 모든 코덱을 보장하지 않습니다. 공급자/메모리로 작은 파일도 실패할 수 있습니다. 실시간 입력/명령/번역의 녹음/인식/처리/결과 표시를 먼저 종료 또는 취소합니다.

자막과 시간

SRT HH:MM:SS,mmm, VTT HH:MM:SS.mmm, ASS H:MM:SS.cc(기본 1920×1080), LRC [mm:ss.cc](100분의 1초), 타임스탬프 TXT(정수초)를 개별/모두 내보냅니다.

표기가 실제 정렬 정확도를 보장하지 않습니다. 단어/구간/원시 시간 없음은 엔진별로 다르며 화면에 표시합니다. 원시 cue가 없으면 텍스트에서 만들 수 있습니다. 내용과 시간을 검토하세요.

로컬 MOSS-0.9B는 화자 분리와 시작/끝 시간 지원. 해당 엔진은 파일 전체 패스로 청크 간 화자 단절을 줄이며 결과는 녹음/모델에 따릅니다. 완료 작업에는 AI 자막 최적화와 원본 복원이 있습니다. 텍스트 처리/의도 모델 또는 준비된 로컬을 사용하며 클라우드는 자막 텍스트를 받습니다. 모델이 없으면 일부 분할은 로컬 규칙으로 대체됩니다.

CLI

커뮤니티 CLI는 GUI 활성화 없이 가능하며 정책이 별도입니다. 먼저 앱에서 모델을 설치하세요. CLI는 빠진 모델을 내려받지 않습니다.

/Applications/VoiceHotkey.app/Contents/MacOS/VoiceHotkey --transcribe ~/Downloads/interview.mp3 --provider qwen
/Applications/VoiceHotkey.app/Contents/MacOS/VoiceHotkey --transcribe ~/Downloads/meeting.m4a --provider moss

VoiceHotkey --transcribe <file_path> [--provider <name>] [--language <code>]. 실행 경로는 설치에 맞춥니다. 언어는 지원 엔진에만 적용됩니다.

앱에서 Fun-ASR-Nano와 SenseVoice Small을 다운로드하고 사용할 수 있습니다. 음성 모델을 확인하세요. 아래 별칭은 별도의 커뮤니티 CLI에 속합니다.

모델	provider에 사용할 이름
Qwen3 0.6B(기본값)	`qwen`, `qwen3`, `qwen3-asr`, `qwen0.6b`, `qwen3-0.6b`
Qwen3 1.7B	`qwen1.7b`, `qwen3-1.7b`, `qwen-1.7b`
SenseVoice	`sensevoice`, `sensevoice-small`
Fun-ASR-Nano	`funasr`, `funasr-nano`, `funasrnano`
Whisper Turbo	`whisper`, `whisper-turbo`, `whisper-large-v3-turbo`
Whisper Small	`whisper-small`
Distil Whisper	`whisper-distil`, `distil-whisper`
Parakeet	`parakeet`, `parakeet-tdt`
FireRed	`firered`, `fireredasr`
Apple SpeechAnalyzer(macOS 26+)	`apple`, `applespeech`, `apple-speech`, `apple-analyzer`, `analyzer`
레거시 Apple Speech	`apple-legacy`, `legacy`
MOSS	`moss`, `moss-0.9b`, `moss0.9b`

알 수 없는 provider는 Qwen3 0.6B로 대체하며 일반 클라우드 선택 인자가 아닙니다. 입력 옆 같은 이름 .srt/.vtt를 만들고 기존 파일을 덮어쓰며, 앱에 표시할 작업도 저장합니다.

로컬 전용

준비된 Apple/로컬 모델을 사용하고 레거시 Apple은 로컬 강제합니다. 공개 인식은 차단, 루프백도 엔진 권한이 필요합니다. 초기 모델/언어 준비는 네트워크가 필요할 수 있습니다. 로컬 전용을 참조하세요.