Problemen oplossen
Wat elke melding van Keebye betekent en hoe je die oplost, plus hoe je alles terugzet.
De meeste problemen komen neer op een recht, een ontbrekend model of dictatie die is gepauzeerd. Begin met de snelle checks en zoek daarna je melding hieronder op.
Doet de hotkey niets? Check dit eerst
- "Enable Dictation" is aangevinkt in het menubalkmenu.
- Je bent ingelogd en de proefperiode is niet voorbij (Settings › Account).
- Toegankelijkheid staat aan in Systeeminstellingen › Privacy en beveiliging › Toegankelijkheid.
- Er staat geen beveiligde invoer aan — bijvoorbeeld Secure Keyboard Entry in Terminal of een wachtwoordveld met focus.
Meldingen en wat ze betekenen
"Accessibility permission was revoked — reopen System Settings"
De toegankelijkheidstoestemming ontbrak toen de opname begon. Open Systeeminstellingen › Privacy en beveiliging › Toegankelijkheid en zet Keebye aan. Keebye activeert de hotkey binnen 2 seconden opnieuw.
"Failed to start the global hotkey listener"
macOS weigerde de event tap. Geef toegang tot Toegankelijkheid en kies daarna je toets opnieuw in Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." of "Could not switch to <Key>; still using <Key>."
De hotkey wijzigen is geweigerd. Geef toegang tot Toegankelijkheid en kies de toets opnieuw; tot die tijd blijft Keebye de vorige toets gebruiken.
"Microphone capture failed: <error>"
Er is geen standaard invoerapparaat of de audiostream is mislukt. Controleer het invoerapparaat in Systeeminstellingen › Geluid en of de microfoontoegang is gegeven.
"Speech model still setting up — try again in a moment"
Het gekozen model staat niet op schijf of is nog niet ingeladen. Wacht tot de pil de downloadstatus verlaat of druk op "Download model" in Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Vijf downloadpogingen zijn mislukt (netwerk, HTTP-fout of checksum die niet klopt). Sluit Keebye af en open het opnieuw; de download gaat verder waar hij was gestopt.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
De engine Native (Apple Speech) is gekozen zonder toestemming. Geef toegang tot Spraakherkenning of stap over op Parakeet of Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" of "Apple Speech timed out after 15s"
Problemen met de Native-engine. Misschien moet het on-device taalmodel nog worden geïnstalleerd via Systeeminstellingen › Toetsenbord › Dicteren; spreek anders binnen 15 seconden of wissel van engine.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" of "Couldn't insert: A password field is focused — dictation is blocked"
Een wachtwoordveld heeft de focus of een app heeft Secure Keyboard Entry aanstaan (Terminal, bijvoorbeeld). Klik in een gewoon tekstveld of zet Secure Keyboard Entry uit. Dit is met opzet zo.
"Text left on clipboard — paste manually"
Het simuleren van ⌘V of van de toetsaanslagen is mislukt. Het transcript staat op je klembord; druk zelf op ⌘V.
"Dictation hit an internal error and was reset. Please try again."
De sessieworker is hersteld van een crash. Dicteer opnieuw.
Het onboardingvenster ging na een update of herinstallatie weer open
Een verouderde toegankelijkheidstoestemming. Verwijder Keebye met de −-knop uit Systeeminstellingen › Privacy en beveiliging › Toegankelijkheid, voeg het opnieuw toe en zet het aan.
Keebye terugzetten
Sluit Keebye af, verwijder ~/Library/Application Support/com.keebye.app/settings.json en verwijder het Keychain-item voor de service com.keebye.app, account auth. Start opnieuw en de onboarding begint weer van voren. Diagnostiek gaat alleen naar stderr.