For AI agents: full index at https://keebye.com/llms.txt

Hoppa till dokumentationens innehåll
Keebye Docs

Felsökning

Vad varje meddelande Keebye visar betyder och hur du åtgärdar det, plus hur du återställer appen.

De flesta problem beror på en behörighet, en modell som saknas eller på att dikteringen är pausad. Börja med snabbkontrollerna och hitta sedan ditt meddelande nedan.

Gör hotkeyn ingenting? Kontrollera det här först

  1. "Enable Dictation" är markerat i menyraden.
  2. Du är inloggad och provperioden har inte tagit slut (Settings › Account).
  3. På en Mac är Accessibility beviljad i System Settings › Privacy & Security › Accessibility.
  4. På en Mac är ingen säker inmatning aktiv — till exempel Secure Keyboard Entry i Terminal, eller ett lösenordsfält med fokus.

Meddelanden och vad de betyder

"Accessibility permission was revoked — reopen System Settings"

Accessibility-behörigheten saknades när inspelningen startade. Öppna System Settings › Privacy & Security › Accessibility och slå på Keebye. Keebye aktiverar hotkeyn igen inom 2 sekunder.

"Failed to start the global hotkey listener"

macOS nekade event tap-en. Ge Accessibility-behörighet och välj sedan din tangent igen i Settings.

"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." eller "Could not switch to <Key>; still using <Key>."

Bytet av hotkey nekades. Ge Accessibility-behörighet och välj tangenten igen; Keebye fortsätter använda den tidigare tangenten till dess.

"Microphone capture failed: <error>"

Det finns ingen standardenhet för ljudingång, eller ljudströmmen misslyckades. Kontrollera ingången i ljudinställningarna (System Settings › Sound på en Mac) och att Microphone-behörighet är beviljad.

"Speech model still setting up — try again in a moment"

Den valda modellen finns inte på disk eller har inte laddats färdigt. Vänta tills statusindikatorn lämnar nedladdningsläget, eller tryck på "Download model" i Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Fem nedladdningsförsök misslyckades (nätverk, HTTP-fel eller felaktig kontrollsumma). Avsluta och öppna Keebye igen; nedladdningen fortsätter där den stannade.

"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"

Motorn Native (Apple Speech) är vald utan behörighet. Ge Speech Recognition-behörighet, eller byt till Parakeet eller Canary.

"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" eller "Apple Speech timed out after 15s"

Problem med Native-motorn. Språkmodellen på enheten kan behöva installeras via System Settings › Keyboard › Dictation; i övrigt: prata inom 15 sekunder eller byt motor.

"Couldn't insert: Secure input is active (<App>) — dictation is blocked" eller "Couldn't insert: A password field is focused — dictation is blocked"

Ett lösenordsfält har fokus eller en app har Secure Keyboard Entry på (till exempel Terminal). Klicka i ett vanligt textfält eller stäng av Secure Keyboard Entry. Det här är avsiktligt.

"Text left on clipboard — paste manually"

Syntetiseringen av ⌘V (Ctrl+V på Windows) eller av tangenttrycken misslyckades. Transkriptet ligger i ditt urklipp; klistra in det själv.

"Dictation hit an internal error and was reset. Please try again."

Sessionsarbetaren återhämtade sig från en krasch. Diktera igen.

Onboardingfönstret öppnades igen efter en uppdatering eller ominstallation (Mac)

En gammal Accessibility-behörighet. Ta bort Keebye från System Settings › Privacy & Security › Accessibility med −-knappen, lägg tillbaka appen och slå på den.

Windows SmartScreen visar "Windows skyddade datorn"

Installationsprogrammet för Windows är inte kodsignerat än. Välj Mer information och sedan Kör ändå — men bara för ett installationsprogram som du har laddat ner från keebye.com.

På Windows spelar dikteringen inte in något

Windows kan blockera mikrofonåtkomst för skrivbordsappar. Öppna Settings › Privacy & security › Microphone, tillåt skrivbordsappar att använda mikrofonen och kontrollera att rätt ingångsenhet är vald.

Återställ Keebye

Avsluta Keebye, ta bort settings.json (i ~/Library/Application Support/com.keebye.app/ på en Mac, %APPDATA%\com.keebye.app\ på Windows) och ta bort den sparade inloggningsuppgiften för tjänsten com.keebye.app, kontot auth, från macOS Keychain eller Windows Credential Manager. Starta appen igen och onboardingen börjar om. Diagnostik går bara till stderr.