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

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

प्रकटीकरण: हम Lightning Assist बनाते हैं, एक paid text expander — इसलिए Espanso हमारा प्रतिस्पर्धी है। Espanso मुफ़्त और open source है, और नीचे दिया गया हर fix ख़ुद Espanso के लिए है; किसी के लिए भी tool बदलने की ज़रूरत नहीं।

7 सितंबर 2026 को अपडेट: Espanso 2.4.1 और Ubuntu 26.04 के लिए #9 फिक्स फिर से लिखा गया, जो अब X11 सेशन नहीं भेजता।

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 चलाने का प्रयास करें

9. Espanso Wayland पर शुरू नहीं होता

Wayland सेशंस पर (जो Ubuntu, Fedora और हर वर्तमान GNOME डेस्कटॉप पर डिफ़ॉल्ट होता है), Espanso को उसके समर्पित Wayland बिल्ड और बाइनरी पर एक बार की अनुमति की आवश्यकता होती है; इनके बिना यह शुरू नहीं होता, या शुरू होता है लेकिन कभी विस्तार नहीं करता (issue #2223)।

समाधान: अपने सेशन प्रकार को echo $XDG_SESSION_TYPE से जांचें। अगर यह wayland कहता है:

1. Wayland-विशिष्ट पैकेज इंस्टॉल करें (espanso-debian-wayland-amd64.deb Debian/Ubuntu पर, Fedora पर Terra RPM), X11 वाला नहीं।
2. Espanso को /dev/input पढ़ने और /dev/uinput में लिखने की क्षमता दें: sudo setcap "cap_dac_override+p" $(which espanso)। यह Espanso के अपने Linux इंस्टॉल गाइड में दिया गया कदम है। फ़ाइल क्षमताएँ बाइनरी से जुड़ी होती हैं, इसलिए अगर Espanso अपग्रेड के बाद विस्तार रुक जाता है, तो इसे फिर से चलाएं।
3. espanso service register और espanso start चलाएं।

सुनिश्चित करें कि आप Espanso 2.4.0 या बाद का संस्करण उपयोग कर रहे हैं (2.4.0 21 जुलाई 2026 को और 2.4.1 2 सितंबर 2026 को जारी हुआ)। 2.4.0 ने wlroots कंपोज़िटर्स (Sway, Hyprland, labwc, Wayfire) के लिए ऐप डिटेक्शन जोड़ा और Fedora के Wayland सेशन पर इंस्टॉल फेलियर ठीक किया; 2.4.1 ने Linux पर डेस्कटॉप फ़ाइल और आइकन जोड़ा। इसके बावजूद, Espanso का इंस्टॉल गाइड अभी भी Wayland सपोर्ट को "प्रयोगात्मक" बताता है: गैर-अमेरिकी कीबोर्ड लेआउट्स को मैन्युअली कॉन्फ़िग में सेट करना पड़ता है, ऐप-विशिष्ट मैच केवल KDE पर kdotool इंस्टॉल होने पर काम करते हैं, GNOME क्लिपबोर्ड बैकएंड के साथ हल्का झिलमिलाहट दिखाता है, और नया प्लग-इन किया गया कीबोर्ड espanso restart की जरूरत होती है।

2026 में एक बदलाव यह है: GNOME पर "बस X11 सेशन में लॉगिन करें" अब विकल्प नहीं रहा। GNOME 50 ने X11 सेशन पूरी तरह हटा दिया, इसलिए Ubuntu 26.04 LTS — और GNOME 50 पर कोई भी अन्य वितरण — केवल Wayland पर है (X11 ऐप्स अभी भी XWayland के जरिए चलते हैं, लेकिन Espanso का X11 बिल्ड नेटिव Wayland ऐप्स के कीस्ट्रोक नहीं देख सकता)। अगर वहां Wayland विस्तार अस्थिर रहता है, तो बचा विकल्प है कोई ऐसा कंपोज़िटर जिसे Espanso अच्छी तरह संभालता हो (KDE या कोई wlroots कंपोज़िटर) या कोई ऐसा टेक्स्ट एक्सपैंडर जिसका Wayland सपोर्ट प्रयोगात्मक न हो — हमारे Wayland टेक्स्ट एक्सपैंशन गाइड देखें।

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

espanso log

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

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

फ़ीचर	Espanso	Lightning Assist
खुला स्रोत	✅	❌ (वाणिज्यिक, 14-दिवसीय परीक्षण)
मूल्य निर्धारण	मुफ़्त/दान	मुफ़्त (20 तक स्निपेट, फ़ोल्डर और एक टीम); Pro $5.99/माह। एआई सुविधाओं को एआई क्रेडिट (Pro में हर महीने 1000 क्रेडिट शामिल हैं, मुफ़्त प्लान में ज़रूरत के अनुसार खरीदे जाते हैं) के माध्यम से मीटर किया जाता है।
क्रॉस-प्लेटफ़ॉर्म (Windows, macOS, Linux)	✅	✅
विन्यास	YAML फ़ाइलें	ग्राफ़िकल संपादक
एआई कमांड (पुनः लिखना, बढ़ाना, आदि)	❌	✅ - AI क्रेडिट, सब्सक्रिप्शन की ज़रूरत नहीं
पुश-टू-टॉक वॉयस-टू-टेक्स्ट	❌	✅ - फ्री टियर पर भी काम करता है, 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 देखें।