Espanso काम नहीं कर रहा? 8 सामान्य सुधार (2026)

Espanso एक शक्तिशाली ओपन-सोर्स टेक्स्ट विस्तारक है, लेकिन इसके YAML-आधारित कॉन्फ़िगरेशन का मतलब है कि चीजें ऐसे तरीकों से गलत हो सकती हैं जो स्पष्ट नहीं हैं। यहां Espanso के काम करना बंद करने के सबसे आम कारण हैं - और उनमें से प्रत्येक को कैसे ठीक किया जाए। आधिकारिक सीएलआई और पथों के लिए, Espanso दस्तावेज़ देखें।

1. Espanso नहीं चल रहा है

सबसे आम कारण: Espanso सेवा प्रारंभ नहीं हुई है.

ठीक करें:

espanso start

जांचें कि क्या यह चल रहा है:

espanso status

systemd के साथ Linux पर:

systemctl --user status espanso
systemctl --user start espanso

2. YAML आपके कॉन्फ़िगरेशन में सिंटैक्स त्रुटि

जब किसी कॉन्फ़िगरेशन फ़ाइल में अमान्य YAML होता है तो Espanso चुपचाप विफल हो जाता है। एक ग़लत रखा गया टैब या कोलन पूरी फ़ाइल को तोड़ देता है।

ठीक करें: कॉन्फिग डॉक्टर चलाएँ:

espanso doctor

जाँचने योग्य सामान्य गलतियाँ:

• रिक्त स्थान के बजाय टैब का उपयोग करना (YAML को रिक्त स्थान की आवश्यकता है)
• उस पाठ के आस-पास गुम उद्धरण जिसमें :, #, या \ जैसे विशेष वर्ण शामिल हैं
• इंडेंटेशन जो एक स्थान से बंद है
• एक replace: मान जो { से शुरू होता है - इसे उद्धृत किया जाना चाहिए: replace: "{{clipb}}"

यदि मौन YAML विफलताएं आपकी टीम के लिए एक आवर्ती समस्या है, तो एक GUI-आधारित स्निपेट संपादक समस्या को पूरी तरह से दूर कर देता है - आप आंखों से इंडेंटेशन को सत्यापित करने के बजाय फ़ील्ड को एक फॉर्म में संपादित करते हैं।

3. Espanso किसी विशिष्ट एप्लिकेशन में काम नहीं करना

कुछ एप्लिकेशन - विशेष रूप से इलेक्ट्रॉन ऐप्स (वीएस कोड, Slack, डिस्कॉर्ड), टर्मिनल, और कस्टम इनपुट हैंडलिंग वाले ऐप्स - Espanso के सिम्युलेटेड कीस्ट्रोक्स को सही ढंग से प्राप्त नहीं करते हैं।

Linux को ठीक करें: सुनिश्चित करें कि आप सही इंजेक्शन बैकएंड का उपयोग कर रहे हैं। संपादित करें ~/.config/espanso/config/default.yml:

backend: Auto

Auto, Clipboard, और Inject के बीच स्विच करने का प्रयास करें:

backend: Clipboard

Windows को ठीक करें: Espanso को व्यवस्थापक के रूप में चलाएं, विशेष रूप से उन ऐप्स के लिए जो उन्नत विशेषाधिकारों के साथ चलते हैं।

macOS को ठीक करें: सिस्टम सेटिंग्स → गोपनीयता और सुरक्षा → एक्सेसिबिलिटी पर जाएं, Espanso को सूची से हटाएं, फिर इसे दोबारा जोड़ें।

4. अनुपलब्ध पहुंच अनुमतियाँ (macOS)

एक्सेसिबिलिटी अनुमतियों के बिना, Espanso कीस्ट्रोक्स की निगरानी नहीं कर सकता या टेक्स्ट आउटपुट का अनुकरण नहीं कर सकता।

ठीक करें:

1. सिस्टम सेटिंग्स खोलें → गोपनीयता और सुरक्षा → एक्सेसिबिलिटी
2. सूची में Espanso ढूंढें
3. इसे टॉगल करें, फिर वापस चालू करें
4. पुनः आरंभ करें Espanso: espanso restart

यह अनुमति-रीसेट नृत्य प्रत्येक macOS पॉइंट रिलीज़ के बाद आम है। यदि आप इसे दोहराना नहीं चाहेंगे, तो देखें कि Lightning Assist macOS अनुमतियों को कैसे संभालता है (एकल अनुदान सिस्टम अपडेट को बरकरार रखता है)।

💡 उपयोग करने की तुलना में Espanso को ठीक करने में अधिक समय व्यतीत हो रहा है? लाइटनिंग असिस्ट एक ग्राफिकल टेक्स्ट विस्तारक है जिसमें कोई YAML फ़ाइलें नहीं हैं, अंतर्निहित AI कमांड और समान Linux समर्थन है। 14 दिनों के लिए निःशुल्क प्रयास करें → - कोई क्रेडिट कार्ड नहीं।

5. ट्रिगर फायरिंग नहीं - गलत ट्रिगर प्रकार

डिफ़ॉल्ट रूप से, Espanso शब्द ट्रिगर्स का उपयोग करता है जो केवल शब्द विभाजक (स्पेस, न्यूलाइन, विराम चिह्न) के बाद विस्तारित होता है। यदि आप किसी शब्द के बीच में अपना ट्रिगर टाइप कर रहे हैं, तो इसका विस्तार नहीं होगा।

ठीक करें: मिलान फ़ाइल में अपना ट्रिगर प्रकार जांचें। यदि आप कहीं भी ट्रिगर करना चाहते हैं तो word: false का उपयोग करें:

matches:
  - trigger: ":sig"
    replace: "Best regards,\nYour Name"
    word: false

या अधिक नियंत्रण के लिए regex ट्रिगर प्रकार का उपयोग करें:

matches:
  - regex: ":sig$"
    replace: "Best regards,\nYour Name"

6. Espanso सिस्टम अपडेट के बाद काम नहीं कर रहा है

ओएस अपडेट - विशेष रूप से macOS और Linux पर - अक्सर एक्सेसिबिलिटी अनुमतियों को रद्द कर देते हैं या सिस्टम सेवा को तोड़ देते हैं।

ठीक करें:

1. एक्सेसिबिलिटी अनुमतियाँ पुनः प्रदान करें (macOS के लिए फिक्स 4 देखें)
2. Linux पर, सिस्टमड सेवा को पुनः पंजीकृत करें: espanso service register
3. Windows पर, जांचें कि Espanso अभी भी स्टार्टअप सूची में है

7. कॉन्फ़िग फ़ाइल ग़लत स्थान पर

Espanso विशिष्ट स्थानों में कॉन्फ़िग फ़ाइलों की तलाश करता है। अपनी .yml मिलान फ़ाइलों को गलत फ़ोल्डर में रखने का मतलब है कि वे कभी लोड नहीं होंगी।

डिफ़ॉल्ट कॉन्फ़िगरेशन स्थान:

• Linux: ~/.config/espanso/
• macOS: ~/Library/Application Support/espanso/
• Windows: %APPDATA%\espanso\

मिलान फ़ाइलें match/ उपनिर्देशिका में होनी चाहिए. अपने सिस्टम के सटीक पथ देखने के लिए espanso path चलाएँ।

8. Espanso किसी अन्य एप्लिकेशन के साथ विरोध

कुछ एप्लिकेशन या एक्सेसिबिलिटी टूल वैश्विक हॉटकी पंजीकृत करते हैं जो Espanso की अपनी कुंजी निगरानी के साथ टकराव करते हैं।

ठीक करें:

• अन्य एक्सेसिबिलिटी टूल, स्क्रीन रीडर या हॉटकी मैनेजर को अस्थायी रूप से अक्षम करें
• त्रुटियों के लिए Espanso लॉग जांचें: espanso log
• पूर्ण निदान के लिए espanso doctor चलाने का प्रयास करें

अभी भी काम नहीं कर रहा? लॉग की जाँच करें

espanso log

इससे पता चलता है कि Espanso क्यों विफल हो रहा है। अनुमति त्रुटियों, पार्सिंग त्रुटियों या बैकएंड समस्याओं को देखें।

एक नज़र में: Espanso बनाम Lightning Assist

फ़ीचर	Espanso	Lightning Assist
खुला स्रोत	✅	❌ (वाणिज्यिक, 14-दिवसीय परीक्षण)
मूल्य निर्धारण	मुफ़्त/दान	$5.99/महीना आधार (स्निपेट, फ़ोल्डर, टीम साझाकरण)। एआई सुविधाओं को एआई क्रेडिट के माध्यम से मीटर किया जाता है, अलग से खरीदा जाता है।
क्रॉस-प्लेटफ़ॉर्म (Windows, macOS, Linux)	✅	✅
विन्यास	YAML फ़ाइलें	ग्राफ़िकल संपादक
एआई कमांड (पुनः लिखना, बढ़ाना, आदि)	❌	✅ - प्रीमियम + एआई क्रेडिट
पुश-टू-टॉक वॉयस-टू-टेक्स्ट	❌	✅ - फ्री टियर पर भी काम करता है, AI क्रेडिट का उपभोग करता है
टीम स्निपेट साझा करना	❌ (सामुदायिक समाधान)	✅ बिल्ट-इन
डिबग अनुभव	सीएलआई (espanso doctor, लॉग्स)	जीयूआई स्थिति पैनल

दोनों Windows, macOS, और Linux पर जहाज चलाते हैं। विकल्प आम तौर पर नीचे आता है: क्या आप सीएलआई + कॉन्फिग फ़ाइलें + मुफ़्त (Espanso) या जीयूआई + एआई + वॉयस + भुगतान (Lightning Assist) पसंद करते हैं।

जब Espanso कॉन्फ़िगरेशन एक रखरखाव बोझ बन जाता है

Espanso का YAML कॉन्फ़िगरेशन आपको शक्ति देता है लेकिन वास्तविक घर्षण जोड़ता है - विशेष रूप से प्रारंभ करते समय, मौन विफलताओं को डीबग करना, या ऐसी टीम के साथ सहयोग करना जो कॉन्फ़िगरेशन फ़ाइलों के साथ सहज नहीं है।

यदि आप वास्तव में इसका उपयोग करने की तुलना में Espanso को ठीक करने में अधिक समय व्यतीत कर रहे हैं, तो लाइटनिंग असिस्ट - एक ग्राफिकल Windows, Mac, और Linux के लिए टेक्स्ट विस्तारक](/text-expander) के साथ पूर्ण GUI, अंतर्निहित AI कमांड्स, पुश-टू-टॉक वॉयस टाइपिंग, और टीम स्निपेट) पर विचार करें। साझा करना. कोई कॉन्फ़िग फ़ाइल नहीं, कोई YAML नहीं। 14-दिवसीय निःशुल्क परीक्षण डाउनलोड करें - किसी क्रेडिट कार्ड की आवश्यकता नहीं है।

विस्तृत तुलना के लिए, Lightning Assist बनाम Espanso देखें।