समस्या निवारण
Keebye जो मैसेज दिखाता है उनका मतलब और उन्हें कैसे ठीक करें, साथ ही रीसेट कैसे करें।
ज़्यादातर दिक्कतें किसी permission, गायब मॉडल, या डिक्टेशन के रुके होने तक ही सीमित होती हैं। पहले क्विक चेक्स से शुरू करें, फिर नीचे अपना मैसेज ढूँढें।
hotkey कुछ नहीं कर रही? पहले ये देखें
- ट्रे मेन्यू में "Enable Dictation" चेक है।
- आप साइन इन हैं और ट्रायल खत्म नहीं हुआ है (Settings › Account)।
- System Settings › Privacy & Security › Accessibility में Accessibility दी गई है।
- कोई secure input चालू नहीं है — जैसे Terminal में Secure Keyboard Entry, या कोई फ़ोकस्ड पासवर्ड फ़ील्ड।
मैसेज और उनका मतलब
"Accessibility permission was revoked — reopen System Settings"
रिकॉर्डिंग शुरू होते समय Accessibility trust मौजूद नहीं थी। System Settings › Privacy & Security › Accessibility खोलें और Keebye को ऑन करें। Keebye 2 सेकंड के भीतर hotkey दोबारा चालू कर देता है।
"Failed to start the global hotkey listener"
macOS ने event tap ठुकरा दिया। Accessibility access दें, फिर Settings में अपनी key दोबारा चुनें।
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." या "Could not switch to <Key>; still using <Key>."
hotkey बदलना ठुकरा दिया गया। Accessibility access दें और key दोबारा चुनें; तब तक Keebye पिछली key इस्तेमाल करता रहता है।
"Microphone capture failed: <error>"
कोई डिफ़ॉल्ट इनपुट डिवाइस नहीं है या ऑडियो स्ट्रीम फ़ेल हो गई। System Settings › Sound में इनपुट डिवाइस देखें और जाँचें कि Microphone access दी गई है।
"Speech model still setting up — try again in a moment"
चुना हुआ मॉडल डिस्क पर नहीं है या अभी लोड होना पूरा नहीं हुआ। pill के डाउनलोड स्टेट से बाहर आने का इंतज़ार करें, या Settings › Speech engine में "Download model" दबाएँ।
"Model download failed — reopen Keebye to retry"
डाउनलोड की पाँच कोशिशें फ़ेल हुईं (नेटवर्क, HTTP एरर, या checksum mismatch)। Keebye बंद करके दोबारा खोलें; डाउनलोड वहीं से आगे बढ़ता है जहाँ रुका था।
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Native (Apple Speech) इंजन बिना authorization के चुना गया है। Speech Recognition दें, या Parakeet या Canary पर स्विच करें।
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech", या "Apple Speech timed out after 15s"
Native इंजन की दिक्कतें। on-device लैंग्वेज मॉडल को System Settings › Keyboard › Dictation से इंस्टॉल करना पड़ सकता है; वरना 15 सेकंड के भीतर बोलें या इंजन बदलें।
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" या "Couldn't insert: A password field is focused — dictation is blocked"
कोई पासवर्ड फ़ील्ड फ़ोकस्ड है या किसी ऐप में Secure Keyboard Entry ऑन है (जैसे Terminal)। किसी सामान्य टेक्स्ट फ़ील्ड में क्लिक करें या Secure Keyboard Entry बंद करें। यह जान-बूझकर बनाया गया व्यवहार है।
"Text left on clipboard — paste manually"
⌘V या कीस्ट्रोक्स सिंथेसाइज़ करना फ़ेल हो गया। ट्रांसक्रिप्ट आपके क्लिपबोर्ड पर है; ⌘V खुद दबाएँ।
"Dictation hit an internal error and was reset. Please try again."
सेशन वर्कर एक क्रैश से उबर गया। दोबारा डिक्टेट करें।
अपडेट या दोबारा इंस्टॉल करने के बाद ऑनबोर्डिंग विंडो फिर से खुल गई
पुरानी Accessibility grant। System Settings › Privacy & Security › Accessibility से Keebye को − बटन से हटाएँ, दोबारा जोड़ें, और ऑन करें।
Keebye रीसेट करें
Keebye बंद करें, ~/Library/Application Support/com.keebye.app/settings.json डिलीट करें, और service com.keebye.app, account auth वाला Keychain आइटम हटा दें। दोबारा लॉन्च करने पर ऑनबोर्डिंग फिर से शुरू हो जाती है। डायग्नोस्टिक्स सिर्फ़ stderr पर जाते हैं।