Ditando
A tecla push-to-talk, segurar versus tocar, o que a pílula mostra, como o texto é inserido e onde o Keebye se recusa a escrever.
Pressione a tecla push-to-talk, fale, solte. A transcrição roda sobre a fala inteira depois que você solta, e o texto é inserido no app que estiver em primeiro plano.
A tecla push-to-talk
Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." As mudanças valem na hora.
- Fn / Globe
- ⌘ esquerda
- ⌘ direita (padrão)
- ⌥ esquerda
- ⌥ direita
Segurar ou tocar
- Pressionar a tecla começa a gravar imediatamente.
- Soltar depois de 400 ms ou mais: segurar para falar. A gravação para e o texto é inserido.
- Soltar antes de 400 ms: toque. A gravação continua ativa. Um segundo toque para e insere.
- O Esc cancela uma gravação em andamento. Nada é inserido.
- Uma fala única é limitada a 300 segundos (5 minutos); depois disso ela para e insere automaticamente.
A pílula
A pílula é um painel pequeno, sempre visível e que deixa os cliques passarem, no centro inferior da sua tela principal, 96 pt acima da borda de baixo. Ela aparece em todas as Spaces e nunca recebe foco.
- Em repouso: um ícone de microfone.
- "Downloading speech model… NN%" enquanto um modelo é baixado, ou "Model download failed — reopen Keebye to retry".
- "Listening…" → "Transcribing…" → "Inserting…" durante um ditado.
- Mensagens curtas por cerca de 2,6 segundos: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" ou "Dictation paused: secure input on (<App>)".
Como o texto é inserido
Colagem — "Paste (fast)" —, o padrão: o Keebye guarda uma cópia da sua área de transferência, escreve a transcrição como um item temporário que os gerenciadores de área de transferência ignoram, sintetiza ⌘V e, depois de 250 ms, restaura a área de transferência anterior se o Keebye ainda for o dono dela. O "Restore clipboard after paste" está ativo por padrão.
No Terminal.app, iTerm2, Warp, WezTerm e kitty a colagem é dividida em blocos de no máximo 2000 bytes, com intervalos de 50 ms.
Digitação — "Typing (terminals / SSH / any layout)": o Keebye envia teclas Unicode em blocos de 16 caracteres, com 4 ms de intervalo, sem tocar na área de transferência. É independente de layout e funciona via SSH e tmux. Se a digitação falhar, o texto fica na área de transferência e a pílula mostra "Text left on clipboard — paste manually".
Campos de senha e entrada segura
Se a entrada segura estiver ativa, ou se o elemento em foco for um campo de senha, o Keebye não escreve nada na área de transferência e mostra "Couldn't insert: Secure input is active (<App>) — dictation is blocked" ou "Couldn't insert: A password field is focused — dictation is blocked". Esses ditados nunca são salvos no histórico. Uma verificação a cada 5 segundos também avisa "Dictation paused: secure input on (<App>)" enquanto a entrada segura continuar ativa.
O microfone aquecido
O fluxo do microfone começa no seu primeiro ditado e depois continua ativo enquanto o app estiver aberto, por isso o indicador de microfone do macOS fica aceso depois do primeiro uso. Um pré-buffer contínuo de 500 ms é acrescentado ao começo de cada fala. O primeiro ditado de uma sessão ainda pode pagar a latência de abertura do fluxo, e palavras faladas antes desse buffer de 500 ms ainda podem ser cortadas. O áudio é reamostrado para 16 kHz mono e uma troca de dispositivo é detectada em menos de um segundo.