받아쓰기

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

푸시 투 토크 키

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

• Fn / Globe(Windows에서는 오른쪽 Ctrl)
• 왼쪽 ⌘(Windows에서는 왼쪽 Windows 키)
• 오른쪽 ⌘, 기본값(Windows에서는 오른쪽 Windows 키)
• 왼쪽 ⌥(Windows에서는 왼쪽 Alt)
• 오른쪽 ⌥(Windows에서는 오른쪽 Alt)

누르고 있기 또는 탭

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

필

필은 주 화면 아래쪽 가운데, 아래 가장자리에서 96 pt 위에 항상 보이는 작은 패널이며 클릭은 그대로 아래 앱으로 통과합니다. Mac에서는 모든 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(Windows에서는 Ctrl+V)를 합성합니다. 250 ms 뒤 클립보드가 아직 Keebye의 것이면 이전 클립보드를 복원합니다. Mac에서는 전사가 클립보드 관리자가 건너뛰는 임시 페이스트보드 항목으로 들어가고, Windows에서는 일반 텍스트만 복원됩니다. "Restore clipboard after paste"는 기본으로 켜져 있습니다.

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

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

비밀번호 필드와 보안 입력

Mac에서 보안 입력이 켜져 있거나 포커스된 요소가 비밀번호 필드이면, 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>)"이라고 알려줍니다.

켜둔 마이크

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