🔐 mud-enc
أداة مدارك للتشفير

أداة سطر أوامر عربية لتشفير وفك تشفير النصوص والأكواد والملفات — بواجهة RTL كاملة

Arabic-first CLI encryption tool for text, code, and any file type — powered by Fernet (AES-128 + HMAC-SHA256)

---

📚 المحتويات

• نبذة عن الأداة
• مميزات الأداة
• لقطات الأداة
• التثبيت
  • على Termux 📲
  • على توزيعات لينكس🐧
• 📦 نسخة مضغوطة (اختياري)
• ⁉️ المشاكل وحلولها
• 🚀 الإستخدام
• 💡 أمثلة عملية
• 🔒 كيف يعمل التشفير
• 📝 ملف requirements.txt
• 🤝 الإبلاغ عن مشاكل
• 👨‍💻 المطور
• 📜 الرخصة License

---

📖 نبذة عن الأداة

هي جزء من سلسلة Madarik Tools (مدارك) — أداة تشفير عامة تعمل من الطرفية (Terminal)،

---

🎯 مميزات الأداة

• تخصيص واجهة الأداة عند تشغيلها، تستطيع تخصيص ألوان البانر والخطوط واختيار لون للخلفية والتحكم بها من داخل الأداة.
• تشفير وفك تشفير أي نص أو كود برمجي يُلصق مباشرة
• تشفير وفك تشفير أي نوع ملف (نصوص، صور، APK، أرشيفات، إلخ) دون أي فقدان أو تلف بالبيانات
• كشف تلقائي: تلصق نص، والأداة تعرف وحدها إذا كان يحتاج تشفيراً أو فك تشفير
• وضعان لتوليد المفتاح: كلمة مرور (PBKDF2 + Salt عشوائي) أو ملف مفتاح (.key) عشوائي
• تشفير معياري بـ Fernet (AES-128-CBC + HMAC-SHA256) من مكتبة cryptography
• واجهة عربية RTL كاملة مع صناديق وحدود قابلة للتخصيص
• يعمل على Termux (أندرويد) و توزيعات لينكس دون أي تعديل

---

🖼️ لقطات من الأداة

الشكل 1: واجهة البانر الرئيسية

الشكل 2: إختيار ألوان الإطارات للأداة

الشكل 3: إختيار لون خلفية الإطارات

الشكل 4: إختيار لون النصوص

الشكل 5: القائمة الرئيسية

الشكل 6: قائمة التشفير/فك التشفير

---

⚙️ التثبيت

على Termux (أندرويد)

• الخطوة الأولى: تحديث النظام والمكتبات

pkg update && pkg install python -y

• الخطوة الثانية: تثبيت python-cryptography

pkg install python-cryptography -y

⚠️ ملاحظة: على Termux، يتم تثبيت cryptography عبر pkg لتجنب مشاكل التوافق مع ABI، بينما على لينكس يمكن تثبيتها مباشرة عبر pip.

• الخطوة الثالثة: تثبيت المكتبات المطلوبة لعرض النص العربي بالشكل الصحيح

pip install arabic_reshaper python-bidi==0.4.2

• الخطوة الرابعة: تثبيت الخط العربي (للعرض الصحيح)

curl -L "https://fonts.gstatic.com/s/notonaskharabic/v33/RrQ5bpV-9Dd1b1OAGA6M9PkyDuVBePeKNaxcsss0Y7bwvc-VaA.ttf" -o ~/.termux/font.ttf
termux-reload-settings

⚠️ هام: أغلق Termux تماماً من قائمة التطبيقات الخلفية وافتحه من جديد

• الخطوة الخامسة: تثبيت الأداة

curl -L -o ~/mud_enc.py https://raw.githubusercontent.com/mmuhacker/mud-enc/main/mud_enc.py

• الخطوة السادسة: إعطاء صلاحية التنفيذ

chmod +x ~/mud_enc.py

• الخطوة السابعة: إنشاء اختصار التشغيل

ln -sf ~/mud_enc.py $PREFIX/bin/enc

• أو قم بكل شيء بالأمر المُجَمَّع:

pkg update && \
pkg install python -y && \
pkg install python-cryptography -y && \
pip install arabic_reshaper python-bidi==0.4.2 && \
curl -L "https://fonts.gstatic.com/s/notonaskharabic/v33/RrQ5bpV-9Dd1b1OAGA6M9PkyDuVBePeKNaxcsss0Y7bwvc-VaA.ttf" -o ~/.termux/font.ttf && \
termux-reload-settings && \
curl -L -o ~/mud_enc.py https://raw.githubusercontent.com/mmuhacker/mud-enc/main/mud_enc.py && \
chmod +x ~/mud_enc.py && \
ln -sf ~/mud_enc.py $PREFIX/bin/enc

• بعدها شغّل الأداة من أي مكان بالأمر:

enc

---

على توزيعات لينكس 🐧

• الخطوة الأولى: تحديث النظام

sudo apt update && sudo apt upgrade -y

• الخطوة الثانية: تثبيت بايثون إذا لم تكن مثبتة

sudo apt install python3 python3-pip -y

• الخطوة الثالثة: تثبيت cryptography والمكتبات

pip install cryptography arabic_reshaper python-bidi==0.4.2 --break-system-packages

• الخطوة الرابعة: تثبيت الخط العربي وتفعيله في الذاكرة المؤقتة

sudo apt install xfonts-utils -y && \
sudo mkdir -p /usr/share/fonts/truetype/noto && \
sudo curl -L "https://raw.githubusercontent.com/googlefonts/noto-fonts/main/hinted/ttf/NotoNaskhArabic/NotoNaskhArabic-Regular.ttf" -o /usr/share/fonts/truetype/noto/NotoNaskhArabic-Regular.ttf && \
sudo fc-cache -fv

• الخطوة الخامسة: تثبيت الأداة وإعطاء صلاحية التنفيذ

curl -L -o ~/mud_enc.py https://raw.githubusercontent.com/mmuhacker/mud-enc/main/mud_enc.py && \
chmod +x ~/mud_enc.py

• الخطوة السادسة: إنشاء الاختصار enc

sudo ln -sf ~/mud_enc.py /usr/local/bin/enc

• أو قم بعمل كل شيء بالأمر المُجَمَّع:

sudo apt update && \
pip install --upgrade pip && \
pip install --user cryptography arabic_reshaper python-bidi==0.4.2 && \
sudo apt install xfonts-utils -y && \
sudo mkdir -p /usr/share/fonts/truetype/noto && \
sudo curl -L "https://raw.githubusercontent.com/googlefonts/noto-fonts/main/hinted/ttf/NotoNaskhArabic/NotoNaskhArabic-Regular.ttf" -o /usr/share/fonts/truetype/noto/NotoNaskhArabic-Regular.ttf && \
sudo fc-cache -fv && \
curl -L -o ~/mud_enc.py https://raw.githubusercontent.com/mmuhacker/mud-enc/main/mud_enc.py && \
chmod +x ~/mud_enc.py && \
sudo ln -sf ~/mud_enc.py /usr/local/bin/enc

• شغّل الأداة

enc

---

📦 نسخة مضغوطة (اختياري)

#-نسخة-مضغوطة-اختياري

النسخة الرئيسية بالمستودع (mud_enc.py) هي الكود المصدري الكامل والمقروء — تقدر تراجعه بنفسك قبل التشغيل، وهذا موصى به دائماً خصوصاً لأداة تشفير.

لمن يفضّل نسخة جاهزة مضغوطة بدل قراءة الكود، متوفرة هون: dist/mud_enc_protected.py

النسخة المضغوطة مطابقة وظيفياً 100% للنسخة الأصلية (نفس الكود، بس مضغوط ومعمّى بأداة خاصة)، وتُستخدم بنفس الطريقة تماماً.

---

⁉️ المشاكل وحلولها

قد تواجه بعض المشكلات في عمل الأداة وهذه طرق إصلاحها

إذا واجهت مشكلة باستيراد cryptography على Termux (خطأ dlopen / ABI)، ثبّتها عن طريق pkg install python-cryptography بدل pip — نسخة pkg مبنية خصيصاً لبيئة Termux.

---

🚀 الاستخدام

عند التشغيل، تطلب منك الأداة: ١. تخصيص المظهر (اختياري) — لون الإطار، لون خلفيته، لون النص. ٢. طريقة توليد المفتاح — كلمة مرور، أو ملف مفتاح .key (توليد جديد أو تحميل موجود) ٣. من القائمة الرئيسية تختار:

• تشفير / فك تشفير نص — تلصق النص مباشرة، والأداة تكتشف تلقائياً إذا كان يحتاج تشفيراً أو فك تشفير
• تشفير ملف — تعطيها مسار أي ملف، وستعطيك نسخة مشفرة بامتداد .mud
• فك تشفير ملف — تعطيها ملف .mud، وستعيد الملف الأصلي كما هو تماماً

بعد كل عملية، تستطيع أن تحفظ النتيجة أو تنسخ الملف الناتج مباشرة لمجلد التنزيلات (يتم اكتشافه تلقائياً حسب المنصة).

💡 أمثلة عملية

تشفير ملف نصي:

enc ١. اختر "تشفير ملف" ٢. أدخل المسار: /home/user/document.txt ٣. سيتم إنشاء: document.txt.mud

فك تشفير ملف:

enc ١. اختر "فك تشفير ملف" ٢. أدخل المسار: /home/user/document.txt.mud ٣. سيتم استعادة الملف الأصلي

---

🔒 كيف يعمل التشفير

· وضع كلمة المرور: يُشتق مفتاح 256-بت عبر PBKDF2HMAC-SHA256 بـ 200,000 تكرار و Salt عشوائي مختلف بكل عملية — نفس كلمة المرور تعيد نفس الملف الأصلي بالضبط. · وضع ملف المفتاح: مفتاح Fernet عشوائي بالكامل (Fernet.generate_key()) يُحفظ بملف .key منفصل — أقوى من كلمة المرور، لكن يجب أن تحافظ على الملف نفسه. · الملفات تُقرأ وتُكتب بصيغة ثنائية (rb/wb) فتشتغل بشكل صحيح مع أي نوع ملف دون أي تلف بالبيانات. · لا توجد طريقة لاسترجاع البيانات إذا فقدت كلمة المرور أو ملف المفتاح — هذا تصميم مقصود لضمان الأمان الحقيقي.

---

📝 ملف requirements.txt

cryptography>=3.4.8,<50.0.0
arabic-reshaper>=3.0.0
python-bidi==0.4.2

---

🔄 تحديث الأداة

لتحديث الأداة إلى أحدث إصدار:

curl -L -o ~/mud_enc.py https://raw.githubusercontent.com/mmuhacker/mud-enc/main/mud_enc.py
chmod +x ~/mud_enc.py

---

🤝 الإبلاغ عن مشاكل

بما أن هذا المشروع مرخّص بموجب رخصة مدارك تولز — النسخ والتوزيع بدون تعديل، فإن المساهمة بالكود (Pull Requests) غير متاحة، لأن أي تعديل على الكود يتعارض مع شروط الرخصة.

بدلاً من ذلك، يسعدني تلقي ملاحظاتك عبر:

• فتح Issue للإبلاغ عن خطأ أو مشكلة تقنية
• فتح Issue لاقتراح ميزة أو تحسين — سوف أراجعها وأنفذها بنفسي إذا كانت مناسبة.
• التواصل المباشر عبر لأي استفسار

⚠️ لا يُقبل أي Pull Request يحتوي تعديلاً على الكود المصدري، حفاظاً على التزام المشروع برخصته.

---

👨‍💻 المطور

Muhannad Daher

---

📜 الرخصة

هذا المشروع مرخّص بموجب رخصة مدارك تولز — النسخ والتوزيع بدون تعديل مع ذكر المصدر.

بالمختصر:

· ✅ مسموح: نسخ الأداة كاملة غير معدلة، واستخدامها، وإعادة توزيعها، مع ذكر المصدر ورابط المستودع · ❌ ممنوع: تعديل الكود أو توزيع نسخة معدّلة منه، أو ادعاء ملكيته

راجع ملف LICENSE للنص الكامل.

---

صُنع بالعربية كجزء من Madarik Tools

⭐ إذا أعجبتك الأداة، لا تنسَ النجمة! ⭐

---