Syncord

                                                                  $$\ 
                                                                  $$ |
 $$$$$$$\ $$\   $$\ $$$$$$$\   $$$$$$$\  $$$$$$\   $$$$$$\   $$$$$$$ |
$$  _____|$$ |  $$ |$$  __$$\ $$  _____|$$  __$$\ $$  __$$\ $$  __$$ |
\$$$$$$\  $$ |  $$ |$$ |  $$ |$$ /      $$ /  $$ |$$ |  \__|$$ /  $$ |
 \____$$\ $$ |  $$ |$$ |  $$ |$$ |      $$ |  $$ |$$ |      $$ |  $$ |
$$$$$$$  |\$$$$$$$ |$$ |  $$ |\$$$$$$$\ \$$$$$$  |$$ |      \$$$$$$$ |
\_______/  \____$$ |\__|  \__| \_______| \______/ \__|       \_______|
          $$\   $$ |                                                  
          \$$$$$$  |                                                  
           \______/ 

Syncord एक CLI-आधारित फ़ाइल सिंक्रनाइज़ेशन और भंडारण उपकरण है जो Discord का उपयोग एन्क्रिप्टेड फ़ाइल भंडारण के रूप में करता है।

यह आपको फ़ाइलों या पूरे निर्देशिकाओं को Discord पर अपलोड करने, उन्हें स्थानीय रूप से एन्क्रिप्ट और विभाजित करने, और बाद में सुरक्षित रूप से डाउनलोड और पुनर्निर्माण करने की अनुमति देता है; यह सब एक सरल कमांड-लाइन इंटरफ़ेस या एक वैकल्पिक TUI डैशबोर्ड के माध्यम से किया जाता है।

Syncord को एक एकल निष्पादन योग्य (syncord.exe) के रूप में वितरित किया जाता है जिसे PyInstaller का उपयोग करके बनाया गया है। निष्पादन योग्य को सीधे आपके सिस्टम PATH में रखा जा सकता है और कहीं से भी उपयोग किया जा सकता है।

✨ विशेषताएँ

• 🔐 एंड-टू-एंड एन्क्रिप्शन

  • फ़ाइलें अपलोड करने से पहले स्थानीय रूप से एन्क्रिप्ट की जाती हैं।
  • एन्क्रिप्शन कुंजी कभी Discord पर संग्रहीत नहीं होती।
  • कुंजी के बिना डेटा पुनर्प्राप्त नहीं किया जा सकता। सुनिश्चित करें कि अपलोड करने के बाद इसे न बदलें।

• 📦 स्वचालित फ़ाइल विभाजन

  • बड़ी फ़ाइलों को टुकड़ों में बाँट दिया जाता है।
  • टुकड़े Discord अपलोड सीमाओं का पालन करते हैं (Discord सीमा: 8MB; टुकड़ा आकार: एन्क्रिप्शन से पहले 5MB; एन्क्रिप्शन के बाद ~7MB)
  • डाउनलोड पर फ़ाइलों को सहजता से पुनः जोड़ा जाता है। SQLite ट्रैकिंग पार्टिशन के लिए धन्यवाद।

• 📁 निर्देशिका अपलोड

  • एक बार में पूरी निर्देशिकाएँ अपलोड करें।
  • पूरी निर्देशिका और उप-निर्देशिकाओं को भी डाउनलोड करें।

• 🖥️ CLI-प्रथम डिज़ाइन

  • सरल, स्क्रिप्ट करने योग्य कमांड।
  • PATH में जोड़े जाने पर वैश्विक रूप से काम करता है।

• 🧭 TUI डैशबोर्ड

  • इंटरैक्टिव टर्मिनल इंटरफ़ेस।
  • संग्रहीत फ़ाइलों और उपयोग जानकारी देखें।

• 📊 उपयोग आँकड़े

  • अपलोड, डाउनलोड और भंडारण उपयोग पर नज़र रखें।

• 🗄️ स्थानीय मेटाडेटा डेटाबेस

  • SQLite-समर्थित मेटाडेटा।
  • केवल Discord संदेश इतिहास पर कोई निर्भरता नहीं।

📦 स्थापना

पूर्व-निर्मित बाइनरी (अनुशंसित)

1. syncord.exe डाउनलोड करें
2. इसे अपने सिस्टम PATH में शामिल किसी निर्देशिका में रखें
3. स्थापना सत्यापित करें:

syncord --help

अब Syncord को किसी भी निर्देशिका से चलाया जा सकता है।

⚙️ अनिवार्य प्रारंभिक सेटअप

⚠️ Syncord को पहले उपयोग से पहले सेटअप की आवश्यकता है।

Discord बॉट टोकन और Guild ID दोनों अनिवार्य हैं।

आवश्यक कॉन्फ़िगरेशन

• Discord बॉट टोकन।
• Discord Guild ID (सर्वर जहाँ फ़ाइलें अपलोड की जाएँगी)।
• एन्क्रिप्शन कुंजी (स्थानीय रूप से उत्पन्न)।

एक बार का सेटअप कमांड

syncord setup --token YOUR_DISCORD_BOT_TOKEN --guild-id YOUR_GUILD_ID --encryption-key

महत्वपूर्ण नोट्स

• 🔑 एन्क्रिप्शन कुंजी महत्वपूर्ण है।
• ❌ कुंजी खोने का अर्थ है स्थायी डेटा हानि।
• 🔒 Discord आपकी फ़ाइलों को डिक्रिप्ट या पुनर्प्राप्त नहीं कर सकता।
• 🛑 मान्य टोकन और गिल्ड आईडी के बिना Syncord काम नहीं करेगा।

📤 फ़ाइलें अपलोड करना

एकल फ़ाइल अपलोड करें

syncord upload file.ext

पूरी निर्देशिका अपलोड करें

syncord upload folder_name

व्यवहार:

• निर्देशिका के अंदर सभी फ़ाइलें संसाधित की जाती हैं।
• फ़ोल्डर संरचना तार्किक रूप से संरक्षित रहती है।
• प्रत्येक निर्देशिका अपना स्वयं का Syncord फ़ोल्डर नाम स्थान बन जाती है।

📥 फ़ाइलें डाउनलोड करना

syncord download folder_on_syncord/file

Syncord:

1. सभी आवश्यक विभाजनों का पता लगाएगा।
2. उन्हें Discord से डाउनलोड करेगा।
3. स्थानीय रूप से डिक्रिप्ट करेगा।
4. मूल फ़ाइल को पुनः जोड़ेगा।

नोट: यदि कोई फ़ोल्डर प्रदान नहीं किया गया है, तो syncord इसे default मान लेता है जहाँ प्रत्येक फ़ाइल अपलोड की जाती है।

🖥️ TUI डैशबोर्ड

syncord dashboard

डैशबोर्ड प्रदान करता है:

• संग्रहीत फ़ाइलों का अवलोकन।
• फ़ोल्डर और फ़ाइल डाउनलोड करें।
• भंडारण उपयोग।
• इंटरैक्टिव नेविगेशन।

📊 उपयोग आँकड़े

syncord stats

प्रदर्शित करता है:

• कुल अपलोड की गई फ़ाइलें
• कुल डाउनलोड
• भंडारण उपयोग
• अन्य ट्रैक किए गए मीट्रिक

🧾 कमांड सारांश

syncord setup        अनिवार्य प्रारंभिक कॉन्फ़िगरेशन
syncord upload       एक फ़ाइल या निर्देशिका अपलोड करें
syncord download     एक फ़ाइल डाउनलोड करें और पुनर्निर्माण करें
syncord dashboard    टर्मिनल UI डैशबोर्ड लॉन्च करें
syncord stats        उपयोग आँकड़े दिखाएँ

🔐 सुरक्षा मॉडल

• सभी एन्क्रिप्शन स्थानीय रूप से होता है।
• Discord केवल एन्क्रिप्टेड बाइनरी टुकड़ों को संग्रहीत करता है।
• मेटाडेटा SQLite का उपयोग करके स्थानीय रूप से संग्रहीत किया जाता है।
• Discord कभी नहीं देखता:
  • फ़ाइल सामग्री।
  • सादा पाठ फ़ाइल नाम।
  • एन्क्रिप्शन कुंजियाँ।

Syncord मानता है कि आप अपने स्थानीय सिस्टम पर भरोसा करते हैं; Discord पर नहीं।

📁 प्रोजेक्ट संरचना

dist/
 ├── syncord.exe          # निष्पादन योग्य
core/
 ├── db_manager.py        # SQLite मेटाडेटा हैंडलिंग
 ├── setup.py             # कॉन्फ़िगरेशन और सेटअप तर्क
 ├── partition.py         # फ़ाइल खंडीकरण और पुनर्निर्माण
 ├── tui.py               # टर्मिनल UI डैशबोर्ड
 ├── encrypter.py         # एन्क्रिप्शन और डिक्रिप्शन
 ├── discord_handler.py   # Discord बॉट तर्क
files/
 ├── uuid/file.bin        # अस्थायी भंडारण
main.py                   # CLI प्रवेश बिंदु

⚠️ सीमाएँ और नोट्स

• उचित गिल्ड अनुमतियों वाले Discord बॉट की आवश्यकता है। READ_MESSAGE_HISTORY & VIEW_CHANNEL & SEND_MESSAGES & ATTACH_FILES
• Discord दर सीमाओं के अधीन।
• सार्वजनिक क्लाउड स्टोरेज के प्रतिस्थापन के रूप में अभिप्रेत नहीं।
• व्यक्तिगत या नियंत्रित वातावरण के लिए डिज़ाइन किया गया।

📜 अस्वीकरण

यह परियोजना शैक्षिक और व्यक्तिगत उपयोग के लिए है।
Syncord का उपयोग करते समय Discord की सेवा की शर्तों का अनुपालन सुनिश्चित करें।

🧠 भविष्य के अपडेट

आपको जिन समस्याओं का सामना करना पड़ सकता है और जिन्हें जल्द ही ठीक किया जाना चाहिए:

• मल्टी अपलोड पर बॉट के लगातार ऊपर-नीचे होने के कारण Discord से दर सीमित होना।
  • सबसे अच्छा समाधान: कनेक्शन बनाए रखना या प्रत्येक फ़ाइल को अलग-अलग संभालने के बजाय सामूहिक रूप से अपलोड और डाउनलोड करना; इसके लिए partition.py को थोड़ा फिर से लिखने की आवश्यकता होगी।
• अप्रत्याशित aiohttp क्लाइंट बंद न होने की त्रुटि।