_{26.10.09 14:26}

🔧 समस्या निवारण गाइड

FastMediaSorter v2 के लिए मौजूदा समस्या निवारण गाइड. जब समस्या चुने गए बिल्ड पथ (Standard, Lite, Photos, Legacy, या XR / noLegal) पर निर्भर करती है तो FLAVOR_MATRIX.md में दी गई कैनोनिकल संस्करण तालिका इस्तेमाल करें.

---

कनेक्शन समस्याएँ

❌ “SMB सर्वर से कनेक्ट नहीं हो पा रहा”

संभावित कारण:

1. गलत नेटवर्क - फोन को NAS के समान Wi-Fi पर होना चाहिए
2. गलत एड्रेस फ़ॉर्मैट - दोनों फ़ॉर्मैट आज़माएँ:
   • \\192.168.1.100\share
   • smb://192.168.1.100/share
3. फ़ायरवॉल रोक रहा है - NAS फ़ायरवॉल सेटिंग्स जाँचें
4. SMB संस्करण बेमेल - कुछ NAS को अभी भी SMB v2/v3 अनुकूलता चाहिए; अगर सर्वर केवल पुरानी SMB सेटिंग्स दिखाता है तो उसे अपडेट करें

समाधान:

• पहले PC से कनेक्शन टेस्ट करें
• कनेक्शन प्रयासों के लिए NAS लॉग जाँचें
• होस्टनेम की जगह IP एड्रेस आज़माएँ
• यूज़रनेम/पासवर्ड की पुष्टि करें

---

❌ “SFTP कनेक्शन टाइमआउट”

संभावित कारण:

1. गलत पोर्ट (डिफ़ॉल्ट: 22)
2. SSH सर्वर चल नहीं रहा
3. फ़ायरवॉल रोक रहा है

समाधान:

1. पहले PC पर SSH क्लाइंट से टेस्ट करें:
   ssh username@192.168.1.100
2. जाँचें कि SSH सेवा चल रही है या नहीं
3. सेटिंग्स में पोर्ट की पुष्टि करें

---

❌ “Google Drive साइन-इन विफल”

समाधान:

1. ऐप डेटा साफ़ करें: Settings → Apps → FastMediaSorter → Clear Data
2. ऐप फिर से इंस्टॉल करें
3. Google अकाउंट सेटिंग्स → Security → Third-party apps जाँचें

---

❌ “OneDrive साइन-इन विफल”

समाधान:

1. Microsoft अकाउंट की स्थिति जाँचें
2. ऐप डेटा साफ़ करें: Settings → Apps → FastMediaSorter → Clear Data
3. Microsoft अकाउंट सेटिंग्स → Privacy → Apps and services जाँचें

---

❌ “Dropbox साइन-इन विफल”

समाधान:

1. Dropbox अकाउंट की स्थिति जाँचें
2. ऐप डेटा साफ़ करें: Settings → Apps → FastMediaSorter → Clear Data
3. Dropbox अकाउंट सेटिंग्स → Security → Connected apps जाँचें

---

प्रदर्शन संबंधी समस्याएँ

❌ “ऐप धीमा / लैगी है”

बड़े फ़ोल्डर के लिए (5000+ फ़ाइलें):

1. फ़ोल्डर एडिट करें (प्रति-रिसोर्स) → “Disable thumbnails” सक्षम करें
2. दिखने वाली फ़ाइलें घटाने के लिए फ़िल्टर इस्तेमाल करें
3. RAM खाली करने के लिए अन्य ऐप बंद करें

नेटवर्क फ़ोल्डर के लिए:

1. Wi-Fi सिग्नल की मज़बूती जाँचें
2. थंबनेल कैश आकार घटाएँ
3. अगर ज़रूरत न हो तो “Scan subdirectories” = OFF करें

---

❌ “थंबनेल लोड नहीं हो रहे”

लोकल फ़ाइलें:

• स्टोरेज अनुमतियाँ जाँचें
• थंबनेल कैश साफ़ करें
• ऐप रीस्टार्ट करें

नेटवर्क फ़ाइलें:

• धीरे स्क्रॉल करें (थंबनेल on-demand लोड होते हैं)
• नेटवर्क स्पीड जाँचें
• सेटिंग्स में कैश आकार बढ़ाएँ

---

फ़ाइल संचालन में त्रुटियाँ

❌ “कॉपी विफल: अनुमति अस्वीकृत”

लोकल फ़ाइलें:

• स्टोरेज अनुमतियाँ दें: Settings → Apps → Permissions
• जाँचें कि फ़ोल्डर read-only तो नहीं है
• किसी अलग जगह मूव करने की कोशिश करें

नेटवर्क फ़ाइलें:

• जाँचें कि यूज़रनेम को write अनुमति है
• NAS पर शेयर सेटिंग्स की पुष्टि करें

---

❌ “फ़ाइल डिलीट नहीं हो पा रही”

संभावित कारण:

1. फ़ाइल किसी दूसरे ऐप में खुली है
2. write अनुमति नहीं है
3. फ़ाइल सिस्टम-प्रोटेक्टेड है

समाधान:

• अन्य ऐप बंद करें
• फ़ोल्डर अनुमतियाँ जाँचें
• नेटवर्क के लिए: पुष्टि करें कि यूज़र के पास delete अधिकार हैं

---

❌ “मूव ऑपरेशन विफल”

क्रॉस-प्रोटोकॉल मूव (जैसे, Local → SMB):

• ये असल में copy + delete होते हैं
• गंतव्य पर खाली जगह ज़रूरी है
• बड़ी फ़ाइलों के लिए ज़्यादा समय लग सकता है

समाधान:

• उपलब्ध जगह जाँचें
• सुरक्षा के लिए Move की जगह Copy इस्तेमाल करें
• पूरा ऑपरेशन पूरा होने का इंतज़ार करें

---

ऐप क्रैश

❌ “प्लेयर खोलते समय ऐप क्रैश हो जाता है”

सामान्य कारण:

1. करप्ट वीडियो फ़ाइल
2. असमर्थित कोडेक
3. फ़ाइल बहुत बड़ी है (>4GB)

समाधान:

• पुष्टि के लिए फ़ाइल को किसी अलग ऐप में चलाने की कोशिश करें
• फ़ाइल फ़ॉर्मैट जाँचें (समर्थित: MP4, MKV, MOV)
• ऐप कैश साफ़ करें

---

❌ “मीडिया फ़ाइल नहीं चल रही या आवाज़ नहीं आ रही”

समस्या: वीडियो लोड होता है लेकिन काली स्क्रीन दिखती है, या बिना आवाज़ के चलता है.

समाधान:

1. ऊपर के टूलबार में ⓘ (Info) बटन टैप करें
2. “Open in External Player” टैप करें
3. एक विशेष प्लेयर चुनें

यह असमर्थित कोडेक को अन्य ऐप को सौंपने के लिए Secondary Player सुविधा का उपयोग करता है.

---

❌ “स्टार्टअप पर ऐप क्रैश हो जाता है”

समाधान:

1. ऐप कैश साफ़ करें: Settings → Apps → FastMediaSorter → Clear Cache
2. अगर फिर भी हो: ऐप डेटा साफ़ करें (⚠️ सेटिंग्स खो जाती हैं)
3. आख़िरी उपाय के रूप में ऐप फिर से इंस्टॉल करें

---

UI / डिस्प्ले समस्याएँ

❌ “टच ज़ोन काम नहीं कर रहे”

जाँचें कि सक्षम है या नहीं: Settings → Player → “Show touch zones hint on first run” = ON

दिखने योग्य बनाएँ: Settings → Player → “Always show touch zones overlay” = ON

---

❌ “कमांड पैनल के बटन बहुत छोटे हैं”

समाधान: Settings → Player → “Compact player buttons” = OFF

यह सभी बटन और स्पेसिंग का आकार दोगुना कर देता है.

---

❌ “डार्क थीम काम नहीं कर रही”

ऐप सिस्टम थीम का पालन करता है:

• Android Settings → Display → Dark theme = ON

---

डेटा संबंधी समस्याएँ

❌ “पसंदीदा गायब हो गए”

पसंदीदा लोकल रूप से संग्रहीत होते हैं:

• ऐप डेटा साफ़ किया? → पसंदीदा खो गए
• नया डिवाइस? → फिर से चिह्नित करना ज़रूरी है

बचाव:

• Settings → General → Backups, restore and settings export इस्तेमाल करें
• पसंदीदा डिवाइस के लिए लोकल होते हैं; अगर आप नए फोन पर जाते हैं, तो उन्हें फिर से चिह्नित करें या अपने बिल्ड में उपलब्ध ऐप बैकअप/रीस्टोर फ़्लो इस्तेमाल करें

---

❌ “ट्रैश फ़ोल्डर बढ़ता ही जा रहा है”

डिलीट की गई फ़ाइलें .trash/ फ़ोल्डर में जाती हैं और मैन्युअल रूप से खाली किए जाने तक वहीं रहती हैं.

समाधान:

1. Settings → Management → File deletion and trash
2. या मैन्युअल रूप से .trash/ फ़ोल्डर डिलीट करें

---

अब भी समस्या है?

लॉग जाँचें

1. Settings → Management → “Show detailed errors” = ON
2. समस्या को फिर से उत्पन्न करें
3. logcat आउटपुट जाँचें

बग रिपोर्ट करें

यह जानकारी शामिल करें:

• Android संस्करण
• डिवाइस मॉडल
• पुनरुत्पादन के चरण
• त्रुटि संदेश (स्क्रीनशॉट)

सबमिट करें: GitHub Issues

---

---

अनुवाद और EPUB समस्याएँ

❌ “अनुवाद काम नहीं कर रहा या अटक गया है”

संभावित कारण:

1. मॉडल गायब हैं: ऐप OCR मॉडल डाउनलोड करने में विफल रहा.
2. इंटरनेट नहीं है: मॉडल डाउनलोड करने के लिए पहली बार चलाने पर इंटरनेट ज़रूरी है.
3. स्टोरेज भरा हुआ है: मॉडल के लिए जगह नहीं (~50 MB).

समाधान:

1. इंटरनेट कनेक्शन जाँचें.
2. Settings → Media → Other पर जाएँ
3. “Enable Translation” को OFF करके फिर से ON करें.
4. Source Language को “Auto” पर बदलने की कोशिश करें.

---

❌ “EPUB पुस्तक नहीं खुल रही”

संभावित कारण:

1. DRM सुरक्षा: ऐप केवल DRM-मुक्त EPUB का समर्थन करता है.
2. करप्ट फ़ाइल: फ़ाइल अधूरी हो सकती है.
3. बहुत बड़ी फ़ाइल: धीमे नेटवर्क पर >100MB फ़ाइलें टाइमआउट हो सकती हैं.

समाधान:

1. पुष्टि करें कि फ़ाइल अन्य रीडर में खुलती है.
2. अगर नेटवर्क/क्लाउड पर है, तो पहले इसे मैन्युअल रूप से डाउनलोड करने की कोशिश करें.
3. सुनिश्चित करें कि फ़ाइल एक्सटेंशन बिल्कुल .epub है.

---

इंटरनेट Streams समस्याएँ

स्ट्रीम शुरू नहीं होती / एक सेकंड चलकर रुक जाती है

संभावित कारण:

1. URL काम नहीं करता या किसी अलग प्रोटोकॉल पर रीडायरेक्ट हो रहा है.
2. सर्वर को ऑथेंटिकेशन चाहिए (असमर्थित).
3. VPN या कॉर्पोरेट नेटवर्क द्वारा Cleartext http:// रोका गया.

समाधान:

• फिर से कोशिश करने के लिए stream-unavailable डायलॉग में Retry टैप करें.
• ब्राउज़र में URL की पुष्टि करें.
• टेस्ट के लिए VPN को अस्थायी रूप से बंद करें.
• अगर स्ट्रीम रीडायरेक्ट होकर भी विफल हो जाती है, तो Remove टैप करके सही URL फिर से जोड़ें.

कैटलॉग इंपोर्ट स्पिनर रुकता नहीं / अटका रहता है

ऐप कैटलॉग डाउनलोड के लिए एक तेज़ टाइमआउट लगाता है. अगर स्पिनर ~15 सेकंड से ज़्यादा अटका रहता है, तो संभवतः होस्ट तक पहुँचा नहीं जा सकता. अपना इंटरनेट कनेक्शन जाँचें और फिर से कोशिश करें. डायलॉग टाइमआउट पर अपने आप बंद हो जाएगा - यह अनिश्चित काल तक अटका नहीं रहेगा.

HLS / DASH / RTSP में ‘unsupported’ संदेश दिखता है

Standard, Legacy, और XR / noLegal में तीनों प्रोटोकॉल समर्थित हैं, इसलिए यह संदेश बिल्ड की नहीं बल्कि स्ट्रीम या उसके कोडेक की समस्या दिखाता है. Lite और Photos में Streams स्क्रीन बिल्कुल नहीं है, इसलिए वहाँ शुरुआत में ही कोई स्ट्रीम नहीं जोड़ी जा सकती.

मेनू या सेटिंग्स में Streams विकल्प नहीं दिख रहा

• Standard / Legacy / XR / noLegal में: Settings > Media > Streams पर जाएँ और सुनिश्चित करें कि Enable Streams चालू है. ड्रॉपडाउन आइटम तभी दिखता है जब Streams सक्षम हो.
• Photos में: Streams सुविधा इस संस्करण में बनाई ही नहीं गई है.
• Lite में: Streams सुविधा इस संस्करण में भी नहीं है - न चालू करने के लिए कोई टॉगल है, न खोलने के लिए कोई स्क्रीन.

ICY now-playing मेटाडेटा नहीं दिख रहा

ICY मेटाडेटा के लिए एक ऐसे Icecast/Shoutcast स्ट्रीम की ज़रूरत होती है जो Icy-MetaData: 1 हेडर भेजता हो. बिना ICY हेडर वाले सादे http mp3 स्ट्रीम निचले मिनी-कंट्रोल में कोई स्टेशन/ट्रैक जानकारी नहीं दिखाते. यह एक सर्वर-साइड सीमा है.

---

कंटेंट संबंधी समस्याएँ

❌ “Text या PDF फ़ाइलें नहीं दिख रहीं”

समाधान:

1. Settings → Media → Documents जाँचें
2. सुनिश्चित करें कि “Support Text Files” और “Support PDF Files” सक्षम हैं.
3. सुनिश्चित करें कि वे चुने हुए हैं, इसके लिए मुख्य स्क्रीन पर Filters (फ़नल आइकन) जाँचें.
4. फ़ोल्डर को फिर से स्कैन करें (pull-to-refresh).

---

ज्ञात सीमाएँ

• ⚠️ कोई RAW फ़ोटो समर्थन नहीं (CR2, NEF, ARW)
• ⚠️ नेटवर्क पर Undo उपलब्ध नहीं (फ़ाइलें hard-delete होती हैं)
• ⚠️ Lite को छोड़कर हर संस्करण में क्लाउड स्टोरेज बिल्ट-इन है; किसी दिए गए बिल्ड में कौन से प्रोवाइडर उपलब्ध हैं यह अब भी डिवाइस प्लेटफ़ॉर्म पर निर्भर हो सकता है, और FLAVOR_MATRIX.md प्रति-संस्करण तालिका है
• ⚠️ कोई मल्टी-डिवाइस सिंक नहीं (पसंदीदा लोकल होते हैं)

---

आख़िरी बार अपडेट किया गया: 2026-06-05
संस्करण: मौजूदा सार्वजनिक दस्तावेज़ सेट