Diktieren

Push-to-Talk-Taste drücken, sprechen, loslassen. Die Transkription läuft nach dem Loslassen über die ganze Äußerung, und der Text wird in die App eingefügt, die gerade im Vordergrund ist.

Die Push-to-Talk-Taste

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Änderungen greifen sofort.

• Fn / Globe
• Linke ⌘
• Rechte ⌘ (Standard)
• Linke ⌥
• Rechte ⌥

Halten oder antippen

• Das Drücken der Taste startet die Aufnahme sofort.
• Nach 400 ms oder später loslassen: Halten zum Sprechen. Die Aufnahme stoppt und der Text wird eingefügt.
• Vor 400 ms loslassen: Antippen. Die Aufnahme bleibt an. Ein zweites Antippen stoppt und fügt ein.
• Esc bricht eine laufende Aufnahme ab. Es wird nichts eingefügt.
• Eine einzelne Äußerung ist auf 300 Sekunden (5 Minuten) begrenzt; danach stoppt sie und fügt automatisch ein.

Die Pille

Die Pille ist ein kleines, immer sichtbares, klick-durchlässiges Panel unten in der Mitte Ihres Hauptbildschirms, 96 pt über der Unterkante. Sie erscheint auf allen Spaces und übernimmt nie den Fokus.

• Ruhezustand: ein Mikrofon-Symbol.
• "Downloading speech model… NN%", während ein Modell geladen wird, oder "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" während eines Diktats.
• Kurze Meldungen für etwa 2,6 Sekunden: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" oder "Dictation paused: secure input on (<App>)".

Wie Text eingefügt wird

Paste (fast), der Standard: Keebye sichert Ihre Zwischenablage, schreibt das Transkript als flüchtigen Pasteboard-Eintrag, den Clipboard-Manager überspringen, synthetisiert ⌘V und stellt nach 250 ms Ihre vorherige Zwischenablage wieder her, falls Keebye das Pasteboard noch besitzt. "Restore clipboard after paste" ist standardmäßig an.

In Terminal.app, iTerm2, Warp, WezTerm und kitty wird das Einfügen in Blöcke von höchstens 2000 Bytes mit 50-ms-Pausen aufgeteilt.

Typing (terminals / SSH / any layout): Keebye sendet Unicode-Tastenanschläge in Blöcken von 16 Zeichen mit 4 ms Abstand, ohne die Zwischenablage anzufassen. Das ist layout-unabhängig und funktioniert über SSH und in tmux. Schlägt das Tippen fehl, landet der Text in der Zwischenablage und die Pille zeigt "Text left on clipboard — paste manually".

Passwortfelder und sichere Eingabe

Ist die sichere Eingabe aktiv oder das fokussierte Element ein Passwortfeld, schreibt Keebye nichts in die Zwischenablage und zeigt "Couldn't insert: Secure input is active (<App>) — dictation is blocked" oder "Couldn't insert: A password field is focused — dictation is blocked". Solche Diktate werden nie im Verlauf gespeichert. Zusätzlich warnt eine Prüfung im 5-Sekunden-Takt mit "Dictation paused: secure input on (<App>)", solange die sichere Eingabe aktiv bleibt.

Das warme Mikrofon

Der Mikrofon-Stream startet beim ersten Diktat und läuft dann für die Lebensdauer der App weiter, deshalb bleibt die Mikrofon-Anzeige von macOS nach der ersten Nutzung an. Jeder Äußerung wird ein rollender Vorlauf von 500 ms vorangestellt. Das erste Diktat einer Sitzung kann trotzdem die Startzeit des Streams bezahlen, und Wörter, die vor diesem 500-ms-Puffer gesprochen werden, können weiterhin abgeschnitten werden. Audio wird auf 16 kHz mono resampelt, ein Gerätewechsel wird innerhalb einer Sekunde erkannt.