첫 설정

설치 및 권한이 끝난 상태를 가정합니다. 점선 프레임은 스크린샷 자리 표시자입니다(public/screenshots/setup-*.svg).

개요

단계	위치	목표
1	메뉴 바 → 설정	메인 UI 열기
2	일반	실제 받아쓰기를 위해 데모 모드 끄기
3	받아쓰기 모델	엔진 선택, 필요 시 키 입력
4	단축키	받아쓰기 `⌃⌥Space`, 명령 `⌥Space` 확인(변경 가능)
5	텍스트 후처리	띄어쓰기 / 다듬기 (기본값으로 충분)
6	메모 등	종단 간 테스트

1. 설정 열기

VoiceHotkey 메뉴 바 아이콘을 클릭합니다.
설정을 선택합니다.
사이드바 그룹:
- 앱: 일반, 정보, 라이선스
- 음성: 단축키, 받아쓰기 모델, 텍스트 후처리, 음성 명령
- 도구: 파일 전사, 기록

자리 표시자: 설정 창 — 그림 1 · 설정 (자리 표시자 · setup-01-settings.svg)

2. 데모 모드

데모 모드는 마이크를 건너뛰고 데모 텍스트를 사용해 UI를 탐색할 수 있게 합니다. 실제 받아쓰기에는 끄세요.

설정 → 일반을 엽니다.
데모 모드를 찾습니다.
실제 입력용: 끕니다.
메뉴 바 상태가 데모 / 마이크 미사용으로 표시되지 않아야 합니다. 다음으로 마이크·엔진 경고를 해결하세요.

자리 표시자: 데모 모드 토글 — 그림 2 · 일반 · 데모 모드 (자리 표시자 · setup-02-demo.svg)

3. 받아쓰기 모델 선택

설정 → 받아쓰기 모델을 엽니다.
엔진을 고릅니다. 예:
- Apple (온디바이스, 첫 성공에 적합)
- Doubao 등 (플랜에서 Free 제한 확인)
- Whisper / Groq / Soniox / NVIDIA… (Trial/Pro에서 다중 엔진)
클라우드 엔진: API 키를 붙여 넣습니다(키체인에 저장).
필요에 따라 모델 id, 언어, 컨텍스트 용어를 입력합니다.
페이지에 “구성되지 않음” 오류가 없는지 확인합니다.

자리 표시자: 받아쓰기 모델 — 그림 3 · 받아쓰기 모델 (자리 표시자 · setup-03-models.svg)

4. 단축키 확인

설정 → 단축키를 엽니다.
음성 입력을 찾습니다 — 기본 받아쓰기는 ⌃⌥Space, 음성 명령은 **⌥Space**입니다.
탭은 녹음 토글, 길게 누르기는 손을 뗄 때까지 말합니다(트리거 모드에 따름).
충돌하면 다른 조합을 다시 기록하세요.
선택: 나중에 음성 명령과 음성 번역을 바인딩합니다.
손쉬운 사용 경고가 있으면 설치 및 권한을 마칩니다.

자리 표시자: 단축키 페이지 — 그림 4 · 단축키 (자리 표시자 · setup-04-hotkeys.svg)

Quick Send, Esc 취소, 사운드는 주로 일반에 있습니다. 단축키 및 녹음을 참고하세요.

5. 텍스트 후처리 (기본값으로 충분)

옵션	첫 실행
끝 마침표 제거	채팅에 유용
스마트 띄어쓰기 / 단락	기본값으로 충분
단어 치환	고정 오류가 있을 때 추가
LLM 다듬기	LLM 키 필요, 나중에
출력 동작	기본: 캐럿에 삽입
번역	별도 단축키 + 모델

자리 표시자: 텍스트 후처리 — 그림 5 · 텍스트 후처리 (자리 표시자 · setup-05-postprocess.svg)

6. 종단 간 테스트

메모 또는 아무 텍스트 필드를 열고 캐럿이 깜박이도록 클릭합니다.
음성 입력 단축키를 누릅니다(오버레이 / 상태가 바뀌어야 함).
짧은 문장을 말합니다.
다시 탭하거나 길게 누른 손을 떼어 종료합니다.
ASR(및 선택적 다듬기)을 기다리면 캐럿에 텍스트가 나타나야 합니다.
선택: 기록에 새 항목이 있는지 확인합니다.

자리 표시자: 메모에서 받아쓰기 테스트 — 그림 6 · 받아쓰기 시도 (자리 표시자 · setup-06-try.svg)

성공 기준

녹음 피드백
손을 뗀 뒤 텍스트 표시
텍스트가 포커스된 필드에 들어감

실패 시

증상	이동
단축키 무반응	문제 해결 · 단축키
녹음은 되지만 텍스트 없음	문제 해결 · 텍스트 없음
권한이 계속 초기화됨	문제 해결 · 권한

설정 후

단어 치환브랜드명과 습관적인 ASR 오류를 고칩니다.

로컬 전용 모드공용 인터넷을 차단합니다.

음성 명령선택적 음성 단축키.