Syncord

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

Syncord هي أداة مزامنة وتخزين ملفات قائمة على واجهة الأوامر تستخدم Discord كـتخزين ملفات مشفّر.

تتيح لك رفع ملفات أو مجلدات كاملة إلى Discord، وتشفيرها وتقسيمها محليًا، ثم تنزيلها وإعادة بنائها بأمان؛ كل ذلك عبر واجهة أوامر بسيطة أو لوحة تحكم TUI اختيارية.

يتم توزيع Syncord كـملف تنفيذي واحد (syncord.exe) مبني باستخدام PyInstaller. يمكن وضع الملف التنفيذي مباشرة في PATH الخاص بنظامك واستخدامه من أي مكان.

✨ الميزات

• 🔐 تشفير من طرف إلى طرف

  • يتم تشفير الملفات محليًا قبل الرفع.
  • لا يتم تخزين مفتاح التشفير على Discord أبدًا.
  • بدون المفتاح، لا يمكن استرداد البيانات. تأكد من عدم تغييره بعد الرفع.

• 📦 تقسيم الملفات تلقائيًا

  • يتم تقسيم الملفات الكبيرة إلى أجزاء.
  • تتوافق الأجزاء مع حدود رفع Discord (حدود Discord: 8 ميجابايت؛ حجم الجزء: 5 ميجابايت قبل التشفير؛ ~7 ميجابايت بعد التشفير)
  • يتم إعادة تجميع الملفات بسلاسة عند التنزيل. بفضل تتبع الأجزاء عبر SQLite.

• 📁 رفع المجلدات

  • رفع مجلدات كاملة دفعة واحدة.
  • تنزيل المجلد بأكمله والمجلدات الفرعية أيضًا.

• 🖥️ تصميم CLI أولاً

  • أوامر بسيطة قابلة للبرمجة النصية.
  • يعمل عالميًا عند إضافته إلى PATH

• 🧭 لوحة تحكم TUI

  • واجهة طرفية تفاعلية.
  • عرض الملفات المخزنة ومعلومات الاستخدام.

• 📊 إحصائيات الاستخدام

  • تتبع عمليات الرفع والتنزيل واستخدام التخزين.

• 🗄️ قاعدة بيانات وصفية محلية

  • بيانات وصفية مدعومة بـ SQLite.
  • لا اعتماد على سجل رسائل Discord وحده.

📦 التثبيت

الملف التنفيذي المُجمّع مسبقًا (موصى به)

1. قم بتنزيل syncord.exe
2. ضعه في مجلد مشمول في PATH الخاص بنظامك
3. تحقق من التثبيت:

syncord --help

يمكن الآن استدعاء Syncord من أي مجلد.

⚙️ الإعداد الأولي الإلزامي

⚠️ يتطلب Syncord إعدادًا قبل الاستخدام الأول.

كل من رمز البوت Discord ومعرّف الخادم (Guild ID) إلزاميان.

الإعدادات المطلوبة

• رمز بوت Discord.
• معرّف خادم Discord (الخادم الذي سيتم رفع الملفات إليه).
• مفتاح التشفير (يُولَّد محليًا).

أمر الإعداد لمرة واحدة

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        Mandatory initial configuration
syncord upload       Upload a file or directory
syncord download     Download and reconstruct a file
syncord dashboard    Launch terminal UI dashboard
syncord stats        Show usage statistics

🔐 نموذج الأمان

• تتم جميع عمليات التشفير محليًا.
• يخزّن Discord فقط أجزاء ثنائية مشفرة.
• تُخزَّن البيانات الوصفية محليًا باستخدام SQLite.
• لا يطّلع Discord أبدًا على:
  • محتويات الملفات.
  • أسماء الملفات غير المشفرة.
  • مفاتيح التشفير.

يفترض Syncord أنك تثق بنظامك المحلي؛ وليس بـ Discord.

📁 هيكل المشروع

dist/
 ├── syncord.exe          # executable
core/
 ├── db_manager.py        # SQLite metadata handling
 ├── setup.py             # Configuration & setup logic
 ├── partition.py         # File chunking & reconstruction
 ├── tui.py               # Terminal UI dashboard
 ├── encrypter.py         # Encryption & Decryption
 ├── discord_handler.py   # discord bot logic
files/
 ├── uuid/file.bin        # temp storage
main.py                   # CLI entry point

⚠️ القيود والملاحظات

• يتطلب بوت Discord بصلاحيات خادم مناسبة: READ_MESSAGE_HISTORY و VIEW_CHANNEL و SEND_MESSAGES و ATTACH_FILES
• يخضع لحدود معدل الطلبات في Discord.
• غير مخصص كبديل للتخزين السحابي العام.
• مصمم للاستخدام الشخصي أو البيئات الخاضعة للتحكم.

📜 إخلاء مسؤولية

هذا المشروع مخصص للاستخدام التعليمي والشخصي.
تأكد من الامتثال لشروط خدمة Discord عند استخدام Syncord.

🧠 التحديثات المستقبلية

مشكلة قد تواجهها ويجب إصلاحها قريبًا:

• تقييد معدل الطلبات من Discord بسبب الاتصال وفصل الاتصال المستمر للبوت عند الرفع المتعدد.
  • الحل الأفضل: الحفاظ على الاتصال أو الرفع والتنزيل الجماعي معًا بدلاً من معالجة كل ملف على حدة؛ سيتطلب إعادة كتابة partition.py قليلاً.
• خطأ غير متوقع بسبب عميل aiohttp غير مغلق.