Fehlerbehebung
Was jede Meldung von Keebye bedeutet und wie Sie sie beheben, dazu das Zurücksetzen.
Die meisten Probleme liegen an einer Berechtigung, einem fehlenden Modell oder daran, dass das Diktat pausiert ist. Beginnen Sie mit den schnellen Prüfungen und suchen Sie dann Ihre Meldung unten.
Hotkey tut nichts? Prüfen Sie zuerst das
- "Enable Dictation" ist im Tray-Menü angehakt.
- Sie sind angemeldet und die Testphase ist nicht beendet (Settings › Account).
- Auf dem Mac ist der Bedienungshilfen-Zugriff in Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen erteilt.
- Auf dem Mac ist keine sichere Eingabe aktiv — zum Beispiel Secure Keyboard Entry im Terminal oder ein fokussiertes Passwortfeld.
Meldungen und was sie bedeuten
"Accessibility permission was revoked — reopen System Settings"
Die Bedienungshilfen-Freigabe fehlte beim Start der Aufnahme. Öffnen Sie Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen und schalten Sie Keebye ein. Keebye aktiviert den Hotkey innerhalb von 2 Sekunden neu.
"Failed to start the global hotkey listener"
macOS hat den Event Tap abgelehnt. Erteilen Sie den Bedienungshilfen-Zugriff und wählen Sie Ihre Taste in Settings erneut.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." oder "Could not switch to <Key>; still using <Key>."
Der Wechsel des Hotkeys wurde abgelehnt. Erteilen Sie den Bedienungshilfen-Zugriff und wählen Sie die Taste erneut; bis dahin nutzt Keebye weiter die vorherige Taste.
"Microphone capture failed: <error>"
Es gibt kein Standard-Eingabegerät, oder der Audio-Stream ist fehlgeschlagen. Prüfen Sie das Eingabegerät in Ihren Soundeinstellungen (auf dem Mac Systemeinstellungen › Ton) und dass der Mikrofon-Zugriff erteilt ist.
"Speech model still setting up — try again in a moment"
Das gewählte Modell liegt nicht auf der Festplatte oder ist noch nicht fertig geladen. Warten Sie, bis die Pille den Download-Zustand verlässt, oder drücken Sie "Download model" in Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Fünf Download-Versuche sind fehlgeschlagen (Netzwerk, HTTP-Fehler oder falsche Prüfsumme). Beenden Sie Keebye und öffnen Sie es erneut; der Download wird dort fortgesetzt, wo er stehen geblieben ist.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Die Engine Native (Apple Speech) ist gewählt, ohne dass die Freigabe vorliegt. Erteilen Sie die Spracherkennung, oder wechseln Sie zu Parakeet oder Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" oder "Apple Speech timed out after 15s"
Probleme der Native-Engine. Das On-Device-Sprachmodell muss vielleicht über Systemeinstellungen › Tastatur › Diktat installiert werden; sprechen Sie andernfalls innerhalb von 15 Sekunden oder wechseln Sie die Engine.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" oder "Couldn't insert: A password field is focused — dictation is blocked"
Ein Passwortfeld ist fokussiert, oder eine App hat Secure Keyboard Entry aktiv (zum Beispiel Terminal). Klicken Sie in ein normales Textfeld oder schalten Sie Secure Keyboard Entry aus. Das ist so gewollt.
"Text left on clipboard — paste manually"
Das Synthetisieren von ⌘V (unter Windows Strg+V) oder der Tastenanschläge ist fehlgeschlagen. Das Transkript liegt in Ihrer Zwischenablage; fügen Sie es selbst ein.
"Dictation hit an internal error and was reset. Please try again."
Der Session-Worker hat sich von einem Absturz erholt. Diktieren Sie erneut.
Das Onboarding-Fenster ging nach einem Update oder einer Neuinstallation wieder auf (Mac)
Eine veraltete Bedienungshilfen-Freigabe. Entfernen Sie Keebye mit der Taste − aus Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen, fügen Sie es wieder hinzu und schalten Sie es ein.
Windows SmartScreen meldet "Der Computer wurde durch Windows geschützt"
Der Windows-Installer ist noch nicht codesigniert. Wählen Sie "Weitere Informationen" und dann "Trotzdem ausführen" — aber nur bei einem Installer, den Sie von keebye.com heruntergeladen haben.
Unter Windows nimmt das Diktat nichts auf
Windows blockiert möglicherweise den Mikrofonzugriff für Desktop-Apps. Öffnen Sie Einstellungen › Datenschutz und Sicherheit › Mikrofon, erlauben Sie Desktop-Apps den Zugriff auf das Mikrofon und prüfen Sie, ob das richtige Eingabegerät ausgewählt ist.
Keebye zurücksetzen
Beenden Sie Keebye, löschen Sie settings.json (auf dem Mac in ~/Library/Application Support/com.keebye.app/, unter Windows in %APPDATA%\com.keebye.app\) und entfernen Sie die gespeicherten Anmeldeinformationen für den Service com.keebye.app, Account auth, aus dem macOS-Keychain oder der Windows-Anmeldeinformationsverwaltung. Nach dem Neustart beginnt das Onboarding erneut. Diagnosemeldungen gehen nur nach stderr.