समस्या निवारण

यदि आप OpenShot में फ्रीज, क्रैश, या त्रुटि संदेश जैसी समस्या का सामना कर रहे हैं, तो समस्या निवारण के लिए कई विभिन्न तकनीकें उपयोगी हो सकती हैं।

समस्या का निवारण करने के लिए लॉग का उपयोग करना

लॉग एक टेक्स्ट फ़ाइल होती है जो रिकॉर्ड करती है कि OpenShot क्या कर रहा है, साथ ही चेतावनियाँ और त्रुटियाँ भी। ये फ़ाइलें समर्थन टीम को समस्या समझने में मदद कर सकती हैं, भले ही आप स्क्रीन पर कोई त्रुटि संदेश न देखें।

OpenShot आपके होम फ़ोल्डर के अंदर .openshot_qt फ़ोल्डर में दो लॉग फ़ाइलें रखता है। Linux और macOS पर, इस स्थान को ~/.openshot_qt/ के रूप में लिखा जाता है। यह फ़ोल्डर आपके फ़ाइल प्रबंधक में छिपा हो सकता है।

दोनों लॉग फ़ाइलें

फ़ाइल	यह क्या रिकॉर्ड करता है
openshot-qt.log	संपादक में गतिविधि: OpenShot शुरू करना, प्रोजेक्ट लोड करना, सेटिंग्स बदलना, और इंटरफ़ेस का उपयोग करना। समस्या की जांच करते समय यह आमतौर पर शुरू करने के लिए सबसे अच्छा स्थान होता है।
libopenshot.log	OpenShot के वीडियो और ऑडियो इंजन में गतिविधि, वह हिस्सा जो मीडिया पढ़ता है और प्रीव्यू और निर्यात किए गए वीडियो में उपयोग की जाने वाली तस्वीरें और ध्वनि बनाता है। विस्तृत इंजन लॉगिंग प्लेबैक और निर्यात समस्याओं की जांच में मदद कर सकती है।

ये फ़ाइलें एक ही एप्लिकेशन के विभिन्न हिस्सों को रिकॉर्ड करती हैं। समस्या रिपोर्ट करते समय, यदि उपलब्ध हो तो दोनों फ़ाइलें शामिल करें। आपको हर पंक्ति को स्वयं समझने की आवश्यकता नहीं है।

OpenShot के किस हिस्से को लॉग करना है चुनें

इन दो सेटिंग्स को खोजने के लिए संपादित करें → प्राथमिकताएँ → उन्नत खोलें:

प्राथमिकताएँ और मेल खाते टर्मिनल विकल्प

प्राथमिकता	मेल खाता तर्क	लॉग फ़ाइल
उपयोगकर्ता इंटरफ़ेस डिबग लॉगिंग	--debug-ui	openshot-qt.log
वीडियो और ऑडियो इंजन डिबग लॉगिंग	--debug-engine	libopenshot.log

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

उपयोगकर्ता इंटरफ़ेस डिबग लॉगिंग स्टार्टअप, प्रोजेक्ट लोडिंग, सेटिंग्स, या इंटरफ़ेस की समस्याओं के लिए एक अच्छा प्रारंभिक बिंदु है। वीडियो और ऑडियो इंजन डिबग लॉगिंग वीडियो और ऑडियो प्रोसेसिंग के बारे में विवरण जोड़ता है, जो प्लेबैक और निर्यात समस्याओं की जांच में मदद कर सकता है। इंजन लॉग बहुत तेजी से बढ़ सकते हैं और OpenShot को धीमा कर सकते हैं। समस्या दोहराने से ठीक पहले इस सेटिंग को चालू करें, फिर बाद में इसे बंद कर दें।

इंजन प्राथमिकता पहले डिबग मोड (विस्तृत) के नाम से जानी जाती थी। इसका सहेजा गया चालू/बंद सेटिंग नए नाम पर लागू होता है।

एक लॉन्च के लिए टर्मिनल का उपयोग करें

टर्मिनल एक विंडो होती है जहाँ आप कमांड टाइप करते हैं। मेल खाते तर्क प्राथमिकताओं के समान अतिरिक्त विवरण सक्षम करते हैं, और इसे टर्मिनल में भी दिखाते हैं:

openshot-qt --debug-ui

यह एक लॉन्च के लिए इंटरफ़ेस विवरण रिकॉर्ड करता है। परिचित --debug और छोटा -d विकल्प --debug-ui के समान ही अर्थ रखते हैं। वीडियो और ऑडियो इंजन विवरण के लिए, उपयोग करें:

openshot-qt --debug-engine

दोनों प्रकार के विवरण एक साथ इकट्ठा करने के लिए:

openshot-qt --debug-ui --debug-engine

समस्या उत्पन्न करने वाले चरणों को दोहराएं, फिर OpenShot बंद करें और लॉग इकट्ठा करें। ये तर्क आपकी सहेजी गई प्राथमिकताओं को नहीं बदलते। OpenShot को सामान्य रूप से शुरू करने पर आपकी सामान्य लॉगिंग सेटिंग्स वापस आ जाती हैं।

openshot-qt.log लगभग 25 MB पहुँचने पर एक नई फ़ाइल शुरू करता है और तीन पुरानी प्रतियाँ रखता है। libopenshot.log संदेशों के जुड़ने के साथ बढ़ता रहता है। आवश्यक लॉग्स सहेजने के बाद, आप OpenShot बंद रहते हुए पुरानी लॉग फ़ाइलें हटा सकते हैं।

अन्य कमांड-लाइन विकल्प

अधिकांश उपयोगकर्ताओं को केवल ऊपर दिए गए दो नियंत्रणों की आवश्यकता होती है। निम्न विकल्प आपको चुनने देते हैं कि फ़ाइलों में या टर्मिनल में कितना विवरण जाए। यहाँ, console का मतलब टर्मिनल आउटपुट है।

लॉगिंग विकल्प

विकल्प	यह क्या करता है
--debug-ui, --debug, या -d	इससे उपयोगकर्ता इंटरफ़ेस डिबग लॉगिंग उसकी फ़ाइल और टर्मिनल दोनों में सक्षम हो जाती है।
--debug-engine	इससे वीडियो और ऑडियो इंजन डिबग लॉगिंग उसकी फ़ाइल और टर्मिनल दोनों में सक्षम हो जाती है।
--debug-file	टर्मिनल विवरण जोड़े बिना openshot-qt.log में संपादक विवरण जोड़ता है।
--debug-console	फ़ाइल विवरण जोड़े बिना टर्मिनल में संपादक विवरण जोड़ता है।
--log-level LEVEL	दोनों लॉग और उनके टर्मिनल आउटपुट के लिए विवरण स्तर सेट करता है।
--log-file-level LEVEL	दोनों लॉग फ़ाइलों के लिए विवरण स्तर सेट करता है, टर्मिनल सेटिंग्स को बिना बदले।
--log-console-level LEVEL	टर्मिनल में संपादक और इंजन दोनों के लिए विवरण सेट करता है, फ़ाइल सेटिंग्स को अपरिवर्तित छोड़ता है।

विस्तृत संदेशों के लिए LEVEL को debug से बदलें या सामान्य सारांश के लिए info से। warning चेतावनियाँ और त्रुटियाँ दिखाता है; error त्रुटियाँ और गंभीर विफलताएँ दिखाता है; critical केवल गंभीर विफलताएँ दिखाता है। off सामान्य लॉग संदेशों को रोकता है, लेकिन मौजूदा क्रैश डायग्नोस्टिक्स अभी भी लिखे जा सकते हैं। बड़े अक्षरों वाले नाम जैसे DEBUG भी काम करते हैं।

उदाहरण के लिए, टर्मिनल को उसकी सामान्य स्तर पर रखते हुए दोनों फ़ाइलों में विस्तृत संदेश एकत्रित करने के लिए:

openshot-qt --log-file-level debug

यह बड़े इंजन लॉग को भी सक्षम करता है, इसलिए इसे संक्षेप में उपयोग करें। पुराने --debug-file और --debug-console विकल्प अभी भी काम करते हैं, भले ही वे --help में सूचीबद्ध न हों।

पर्यावरण चर

पर्यावरण चर एक नामित सेटिंग होती है जो प्रोग्राम शुरू होने पर उसे दी जाती है। ये तब उपयोगी होते हैं जब OpenShot को स्क्रिप्ट से शुरू किया जाता है या जब कोई सहायता व्यक्ति आपसे किसी विशेष सेटिंग को आजमाने के लिए कहता है। सामान्य उपयोग के लिए इन्हें सेट करने की आवश्यकता नहीं है।

वैकल्पिक पर्यावरण सेटिंग्स

चर	यह क्या नियंत्रित करता है
OPENSHOT_LOG_LEVEL	दोनों फ़ाइलों और टर्मिनल में विवरण।
OPENSHOT_LOG_FILE_LEVEL	केवल दोनों फ़ाइलों में विवरण।
OPENSHOT_LOG_CONSOLE_LEVEL	केवल टर्मिनल में विवरण, OpenShot के दोनों भागों के लिए।
LIBOPENSHOT_LOG_LEVEL	वीडियो और ऑडियो इंजन के लिए विवरण, इसकी फ़ाइल और टर्मिनल में।
LIBOPENSHOT_LOG_FILE_LEVEL	केवल libopenshot.log में विवरण।
LIBOPENSHOT_LOG_CONSOLE_LEVEL	केवल टर्मिनल में इंजन विवरण।

उदाहरण के लिए, यह Linux/macOS टर्मिनल कमांड एक लॉन्च के लिए इसकी फ़ाइल में विस्तृत इंजन लॉगिंग का अनुरोध करता है:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

यदि सेटिंग्स ओवरलैप होती हैं, तो कमांड-लाइन विकल्पों को प्राथमिकता मिलती है, उसके बाद पर्यावरण चर, फिर प्राथमिकताएँ, और फिर सामान्य डिफ़ॉल्ट। प्रत्येक नियंत्रण केवल उस आउटपुट को प्रभावित करता है जिसे वह वर्णित करता है: --debug इंजन प्राथमिकता को ओवरराइड नहीं करता। अस्थायी ओवरराइड आपकी सहेजी गई प्राथमिकताओं को नहीं बदलते। किसी भी चेकबॉक्स पर होवर करें यह देखने के लिए कि क्या कोई अन्य सेटिंग उस लॉग फ़ाइल को नियंत्रित कर रही है।

पर्यावरण सेटिंग्स के भीतर, इंजन के लिए LIBOPENSHOT_ मानों को OPENSHOT_ मानों पर प्राथमिकता दी जाती है। किसी भी समूह के भीतर, केवल फ़ाइल या केवल कंसोल स्तर सामान्य स्तर पर प्राथमिकता रखता है। कमांड-लाइन विकल्प भी उसी फ़ाइल/कंसोल नियम का पालन करते हैं। एक ही आउटपुट के लिए विरोधाभासी कमांड-लाइन स्तर अस्वीकार कर दिए जाते हैं; अमान्य पर्यावरण स्तरों की रिपोर्ट की जाती है और उन्हें अनदेखा किया जाता है।

पुराने स्क्रिप्ट्स के लिए, LIBOPENSHOT_DEBUG अभी भी टर्मिनल में विस्तृत इंजन संदेश सक्षम करता है जब भी यह मौजूद होता है, भले ही इसका मान 0 हो। नए स्तर सेटिंग्स को इसकी प्राथमिकता मिलती है। LIBOPENSHOT_LOG_FILE उन प्रोग्रामों के लिए है जो इंजन को अलग से उपयोग करते हैं; OpenShot स्वयं ऊपर दिए गए लॉग फ़ोल्डर का उपयोग करता है। लॉगिंग सेटिंग्स बदलने से आपकी त्रुटि-रिपोर्टिंग प्राथमिकता नहीं बदलती।

Windows 11 प्रतिक्रिया नहीं दे रहा है

यदि आपको Windows 11 पर फ्रीज का सामना करना पड़ता है, तो यह PyQt5 और Windows 11 के साथ एक ज्ञात समस्या है, जो Qt की पहुँच सुविधा से संबंधित है। यह OpenShot में Ctrl+C दबाने से होता है (केवल Windows 11 पर). OpenShot प्रतिक्रिया देना बंद कर देगा और मेमोरी लीक भी होगा (यानी जितना अधिक OpenShot प्रतिक्रिया नहीं देगा, आपकी मेमोरी लीक उतनी ही बढ़ेगी जब तक OpenShot अंततः क्रैश न हो जाए या उपयोगकर्ता प्रक्रिया को समाप्त न कर दे)।

एक सरल समाधान है कि Windows 11 पर Ctrl+C से बचें, और इसके बजाय राइट-क्लिक Copy/Paste मेनू का उपयोग करें। एक अन्य समाधान है कि अपनी "Copy" को Ctrl+C से किसी अन्य कुंजी, जैसे Alt+C पर पुनः मैप करें। आप OpenShot की Preferences में अपनी कीबोर्ड मैपिंग बदल सकते हैं। देखें कीबोर्ड।

Windows में GDB के साथ डिबगिंग

यदि आप Windows 10/11 में OpenShot के साथ क्रैश या फ्रीज का सामना कर रहे हैं, तो निम्नलिखित चरण-दर-चरण निर्देश आपको क्रैश के कारण का पता लगाने में मदद करेंगे। ये निर्देश क्रैश के स्थान पर OpenShot के स्रोत कोड का स्टैक ट्रेस दिखाएंगे। यह जानकारी हमारे विकास टीम के लिए अत्यंत उपयोगी हो सकती है, और बग रिपोर्ट के साथ संलग्न करने के लिए भी बहुत उपयोगी है (तेजी से समाधान के लिए)।

नवीनतम दैनिक बिल्ड स्थापित करें

डिबगर संलग्न करने से पहले, कृपया OpenShot का नवीनतम संस्करण डाउनलोड करें: https://www.openshot.org/download#daily. इस संस्करण को डिफ़ॉल्ट स्थान पर स्थापित करें: C:\Program Files\OpenShot Video Editor\. Windows पर OpenShot डिबगिंग के लिए विस्तृत निर्देशों के लिए, कृपया इस विकी को देखें।

MSYS2 स्थापित करें

OpenShot का Windows संस्करण MSYS2 नामक एक वातावरण का उपयोग करके संकलित किया गया है। हमारे executable, openshot-qt.exe में GDB डिबगर संलग्न करने के लिए, आपको पहले MSYS2 स्थापित करना होगा। यह चरण केवल एक बार आवश्यक है।

1. MSYS2 डाउनलोड और स्थापित करें: http://www.msys2.org/

2. MSYS2 MinGW x64 कमांड प्रॉम्प्ट चलाएं (उदाहरण के लिए: C:\msys64\msys2_shell.cmd -mingw64)

3. सभी पैकेज अपडेट करें (निम्नलिखित कमांड कॉपी/पेस्ट करें):

   pacman -Syu
   

4. GDB डिबगर स्थापित करें (निम्नलिखित कमांड कॉपी/पेस्ट करें):

   pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
   

GDB डिबगर के साथ OpenShot लॉन्च करें

MSYS2 MinGW x64 कमांड प्रॉम्प्ट चलाएं (उदाहरण के लिए: C:\msys64\msys2_shell.cmd -mingw64)

PATH अपडेट करें (निम्नलिखित कमांड कॉपी/पेस्ट करें):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

OpenShot को GDB डिबगर में लोड करें (निम्नलिखित कमांड कॉपी/पेस्ट करें):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

GDB प्रॉम्प्ट से OpenShot लॉन्च करें (निम्नलिखित कमांड कॉपी/पेस्ट करें):

run --debug

डिबगिंग जानकारी प्रिंट करें

एक बार जब OpenShot GDB के साथ सफलतापूर्वक लॉन्च हो जाए, तो आपको बस OpenShot में क्रैश या फ्रीज ट्रिगर करना है। जब क्रैश होता है, तो MSYS2 MinGW64 टर्मिनल पर वापस जाएं और निम्नलिखित कमांड में से एक चलाएं (टाइप करके ENTER दबाएं)। आमतौर पर, पहली कमांड bt होती है, जिसका अर्थ है backtrace। और कमांड नीचे सूचीबद्ध हैं।

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

उच्च DPI / 4K मॉनिटर

OpenShot Video Editor उच्च DPI (डॉट्स पर इंच) मॉनिटरों के लिए मजबूत समर्थन प्रदान करता है, जिससे इंटरफ़ेस तेज़ और विभिन्न DPI सेटिंग्स वाले डिस्प्ले पर आसानी से पढ़ने योग्य दिखता है। यह समर्थन विशेष रूप से 4K मॉनिटरों और अन्य उच्च-रिज़ॉल्यूशन डिस्प्ले पर सहायक है।

प्रति मॉनिटर DPI जागरूकता

OpenShot प्रति मॉनिटर आधार पर DPI के प्रति जागरूक है, जिसका अर्थ है कि यह प्रत्येक जुड़े मॉनिटर की DPI सेटिंग्स के अनुसार अपने स्केलिंग को गतिशील रूप से समायोजित कर सकता है। यह विभिन्न डिस्प्ले पर एक सुसंगत अनुभव प्रदान करने में मदद करता है।

Windows पर DPI स्केलिंग

Windows पर, OpenShot दृश्य अखंडता बनाए रखने के लिए स्केलिंग फैक्टर को निकटतम पूर्णांक में गोल करता है। इससे UI में दृश्य दोषों से बचा जाता है और इंटरफ़ेस तत्व स्पष्ट और अच्छी तरह संरेखित रहते हैं। इस गोलाई के कारण, कुछ स्केलिंग विकल्प अपेक्षा से बड़े फॉन्ट और UI तत्वों का कारण बन सकते हैं।

• 125% स्केलिंग को 100% पर गोल किया जाता है

• 150% स्केलिंग को 200% पर गोल किया जाता है

सूक्ष्म समायोजन के लिए समाधान

जबकि गोलाई एक साफ़ इंटरफ़ेस बनाए रखने में मदद करती है, उन उपयोगकर्ताओं के लिए समाधान हैं जिन्हें स्केलिंग पर अधिक सटीक नियंत्रण की आवश्यकता होती है। संभावित दृश्य दोषों के कारण ये तरीके सिफारिश नहीं किए जाते हैं:

• QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough

  • इस पर्यावरण चर को सेट करने से गोलाई अक्षम हो सकती है और अधिक सटीक स्केलिंग की अनुमति मिलती है।

  • ध्यान दें: इससे विशेष रूप से टाइमलाइन में दृश्य दोष हो सकते हैं, और यह सिफारिश नहीं किया जाता है।

• QT_SCALE_FACTOR=1.25 (या समान मान)

  • स्केल फैक्टर को मैन्युअल रूप से सेट करने से फॉन्ट और UI स्केलिंग में सूक्ष्म समायोजन संभव होता है।

  • यह प्रेफरेंस (यूजर इंटरफ़ेस स्केल) के माध्यम से भी सेट किया जा सकता है, लेकिन Windows पर भिन्नात्मक स्केल के साथ बॉर्डर/लाइन समस्याओं की उम्मीद करें।

  • ध्यान दें: यह तरीका भी दृश्य दोषों का कारण बन सकता है और OpenShot का उपयोग करना कठिन बना सकता है।

इन पर्यावरण चर को समायोजित करने के बारे में अधिक जानकारी के लिए, कृपया https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large पर जाएं।