단축키 및 녹음

기본 단축키

최초 실행 AppConfig 기본값 기준(설정 → 단축키에서 모두 재할당 가능):

모드	기본	역할
음성 입력	`⌃⌥Space` (Control + Option + Space)	기본 음성 입력
직접 음성 입력	기본값 미할당	다듬기를 건너뛰고 원문 삽입
음성 명령	`⌃⌥C` (Control + Option + C)	명령 사전 / 의도
음성 번역	`⌃⌥⇧Space` (Control + Option + Shift + Space)	전사 후 번역하여 출력

모드마다 보조 단축키(기본 미지정)를 둘 수 있습니다.

트리거 모드 및 길게 누르기

각 단축키 슬롯은 단축키 설정에서 트리거 모드(HotkeyTriggerMode)를 독립적으로 선택할 수 있습니다:

트리거 모드	동작 설명
누르고 있거나 전환 (기본값)	짧게 눌러 시작/종료; 길게 눌러 말하고 떼면 종료(길게 누르기 임계값 약 350ms, 사용자 지정 가능)
전환	누를 때마다 녹음 켜기/끄기 전환, 손을 떼도 종료되지 않음
누르고 있기	PTT(Push-to-Talk) 전용, 누르고 있는 동안 녹음, 떼면 즉시 종료
더블 클릭	빠르게 두 번 눌러 시작/종료, 한 번 누름은 무시

같은 순간에 녹음하는 모드는 하나뿐입니다:

이미 짧게 눌러 전환 세션 중에 같은 모드의 「홀드 전용」 보조 키를 누르고 있으면, 떼는 시점에 해당 세션을 종료합니다(PTT가 한 겹 더 쌓이지 않음).
녹음 중에 다른 모드의 바인딩을 누르면 무시되고 현재 사용 중이라는 안내가 표시됩니다(먼저 종료하거나 Esc를 누르세요). 음성 입력 / 명령 / 번역이 섞이는 것을 막기 위함입니다.

보조 키, 마우스 가운데 버튼 및 트랙패드 제스처

일반적인 키보드 조합 외에도 VoiceHotkey는 다음을 지원합니다:

단일 보조 키 바인딩: 좌/우 ⌘ Command, ⌥ Option, ⌃ Control, ⇧ Shift 구분을 비롯해 Caps Lock 또는 Fn 키를 단일 트리거로 지정할 수 있습니다.
마우스 가운데 버튼: 마우스 휠 가운데 버튼(Middle Click)을 기본 또는 보조 키로 매핑할 수 있습니다.
트랙패드 멀티 터치 제스처: 3손가락, 4손가락, 5손가락 탭 및 4손가락, 5손가락 강하게 누르기(Force Click)를 트리거로 사용할 수 있습니다.

빠른 전송(Quick Send)

녹음 중 Return을 누르면: 녹음을 끝내고 텍스트를 삽입한 뒤 Return을 한 번 더 시뮬레이션합니다(채팅 / 에이전트 입력창에 적합).

설정 → 일반에서 「빠른 전송」을 켜고 끌 수 있습니다. 이는 출력 동작의 삽입 후 전송(음성 입력마다 자동으로 Return)과 별개의 옵션입니다.

녹음 오버레이

녹음 중에는 상태 오버레이(파형 / 상태)가 나타납니다. 비교적 최신 시스템에서는 Liquid Glass 스타일을 사용할 수 있습니다.

취소

녹음, 인식, 다듬기 또는 결과 오버레이가 표시되는 동안 Escape(「설정 → 일반」에서 「Escape 키로 녹음 취소」를 끌 수 있음) 또는 딥링크 voicehotkey://cancel로 취소할 수 있습니다. 오버레이의 닫기 컨트롤은 항상 사용할 수 있습니다. 딥링크 참고.

메뉴 바 아이콘

설정 → 일반에서 메뉴 바 아이콘 표시 여부와 상태 바 아이콘 스타일을 선택할 수 있습니다: 컬러(브랜드 색) 또는 흑백(메뉴 바에 맞춰 자동으로 적응하는 템플릿 아이콘). 메뉴 바 아이콘을 숨기더라도 설정을 열 방법이 완전히 사라지지 않도록 독 항목 하나 이상은 남습니다.