Dicteren

Druk op je push-to-talk-toets, spreek, laat los. De transcriptie draait na het loslaten in één keer over de hele zin en de tekst wordt ingevoegd in de app die vooraan staat.

De push-to-talk-toets

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Wijzigingen werken direct.

• Fn / Globe
• Linker ⌘
• Rechter ⌘ (standaard)
• Linker ⌥
• Rechter ⌥

Ingedrukt houden of aantikken

• Zodra je de toets indrukt, begint de opname.
• Laat je na 400 ms of later los: ingedrukt houden om te praten. De opname stopt en de tekst wordt ingevoegd.
• Laat je voor 400 ms los: een tik. De opname blijft lopen. Een tweede tik stopt en voegt in.
• Esc annuleert een lopende opname. Er wordt niets ingevoegd.
• Eén dictatie is begrensd op 300 seconden (5 minuten); daarna stopt hij en wordt automatisch ingevoegd.

De pil

De pil is een klein, altijd zichtbaar paneeltje onderaan het midden van je primaire scherm, 96 pt boven de onderrand, waar je doorheen kunt klikken. Hij verschijnt in alle Spaces en neemt nooit de focus.

• In rust: een microfoonicoon.
• "Downloading speech model… NN%" terwijl een model wordt gedownload, of "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" tijdens een dictatie.
• Korte meldingen van ongeveer 2,6 seconde: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" of "Dictation paused: secure input on (<App>)".

Hoe tekst wordt ingevoegd

Paste (fast), de standaard: Keebye maakt een momentopname van je klembord, schrijft het transcript als tijdelijk klemborditem dat klembordbeheerders overslaan, simuleert ⌘V en zet na 250 ms je vorige klembord terug als Keebye het klembord nog bezit. "Restore clipboard after paste" staat standaard aan.

In Terminal.app, iTerm2, Warp, WezTerm en kitty wordt het plakken opgeknipt in stukken van maximaal 2000 bytes met 50 ms ertussen.

Typing (terminals / SSH / any layout): Keebye stuurt Unicode-toetsaanslagen in blokjes van 16 tekens, 4 ms na elkaar, zonder het klembord aan te raken. Dat is onafhankelijk van je toetsenbordindeling en werkt over SSH en in tmux. Mislukt het typen, dan komt de tekst op het klembord en toont de pil "Text left on clipboard — paste manually".

Wachtwoordvelden en beveiligde invoer

Staat beveiligde invoer aan, of heeft een wachtwoordveld de focus, dan schrijft Keebye niets naar het klembord en toont het "Couldn't insert: Secure input is active (<App>) — dictation is blocked" of "Couldn't insert: A password field is focused — dictation is blocked". Zulke dictaties worden nooit in de geschiedenis bewaard. Een controle elke 5 seconden waarschuwt daarnaast met "Dictation paused: secure input on (<App>)" zolang beveiligde invoer aanstaat.

De warme microfoon

De microfoonstream start bij je eerste dictatie en blijft daarna lopen zolang de app draait, dus de microfoonindicator van macOS blijft na het eerste gebruik aan. Aan het begin van elke zin wordt een meelopende buffer van 500 ms toegevoegd. De eerste dictatie van een sessie kan nog steeds de starttijd van de stream kosten, en woorden die je vóór die buffer van 500 ms spreekt, kunnen nog wegvallen. Audio wordt omgezet naar 16 kHz mono en een gewijzigd apparaat wordt binnen een seconde opgemerkt.