받아쓰기

푸시 투 토크 키를 누르고, 말하고, 떼세요. 전사는 손을 뗀 뒤 발화 전체를 대상으로 실행되며, 텍스트는 맨 앞에 있는 앱에 삽입됩니다.

푸시 투 토크 키

설정 › Push-to-talk hotkey: "Hold this key to dictate; release to insert."(이 키를 누른 채 말하고, 떼면 삽입됩니다.) 변경은 바로 적용됩니다.

• Fn / Globe
• 왼쪽 ⌘
• 오른쪽 ⌘(기본값)
• 왼쪽 ⌥
• 오른쪽 ⌥

누르고 있기 또는 탭

• 키를 누르면 곧바로 녹음이 시작됩니다.
• 400 ms 이상 지나서 떼기: 누른 채 말하기. 녹음이 멈추고 텍스트가 삽입됩니다.
• 400 ms 안에 떼기: 탭. 녹음이 계속됩니다. 두 번째 탭에서 멈추고 삽입합니다.
• Esc는 진행 중인 녹음을 취소합니다. 아무것도 삽입되지 않습니다.
• 한 번의 발화는 300초(5분)까지이며, 그 시점에 자동으로 멈추고 삽입합니다.

필

필은 주 화면 아래쪽 가운데, 아래 가장자리에서 96 pt 위에 항상 보이는 작은 패널이며 클릭은 그대로 아래 앱으로 통과합니다. 모든 Space에 나타나고 포커스를 가져가지 않습니다.

• 대기 중: 마이크 아이콘.
• 모델을 다운로드하는 동안 "Downloading speech model… NN%", 실패하면 "Model download failed — reopen Keebye to retry".
• 받아쓰기 중에는 "Listening…" → "Transcribing…" → "Inserting…".
• 약 2.6초 동안만 보이는 짧은 메시지: "Couldn't insert: <reason>", "Text left on clipboard — paste manually", "Dictation paused: secure input on (<App>)".

텍스트가 삽입되는 방식

기본값인 Paste (fast): Keebye는 클립보드 내용을 저장해 두고, 클립보드 관리자가 건너뛰는 임시 페이스트보드 항목으로 전사를 쓴 뒤 ⌘V를 합성합니다. 250 ms 뒤 페이스트보드가 아직 Keebye의 것이면 이전 클립보드를 복원합니다. "Restore clipboard after paste"는 기본으로 켜져 있습니다.

Terminal.app, iTerm2, Warp, WezTerm, kitty에서는 붙여넣기가 최대 2000바이트 청크로 나뉘어 50 ms 간격으로 전달됩니다.

Typing (terminals / SSH / any layout): Keebye가 Unicode 키 입력을 16자씩 4 ms 간격으로 보내며 클립보드는 건드리지 않습니다. 키보드 배열과 무관하게 동작하고 SSH와 tmux 너머에서도 작동합니다. 타이핑이 실패하면 텍스트가 클립보드에 남고 필에 "Text left on clipboard — paste manually"가 표시됩니다.

비밀번호 필드와 보안 입력

보안 입력이 켜져 있거나 포커스된 요소가 비밀번호 필드이면, Keebye는 클립보드에 아무것도 쓰지 않고 "Couldn't insert: Secure input is active (<App>) — dictation is blocked" 또는 "Couldn't insert: A password field is focused — dictation is blocked"를 표시합니다. 이런 받아쓰기는 기록에 저장되지 않습니다. 또한 5초마다 확인하면서, 보안 입력이 켜져 있는 동안 "Dictation paused: secure input on (<App>)"이라고 알려줍니다.

켜둔 마이크

마이크 스트림은 첫 받아쓰기에서 시작되고, 그 뒤로는 앱이 실행되는 동안 계속 돌아갑니다. 그래서 한 번 사용한 뒤에는 macOS 마이크 표시등이 계속 켜져 있습니다. 각 발화 앞에는 직전 500 ms의 프리롤이 덧붙습니다. 세션의 첫 받아쓰기는 스트림 시작 지연을 그대로 겪을 수 있고, 그 500 ms 버퍼보다 앞서 말한 단어는 잘릴 수 있습니다. 오디오는 16 kHz 모노로 리샘플링되고, 기기 변경은 1초 안에 감지됩니다.