winget install --id=MesterPerfect.IlmQuiz -e IlmQuiz is an interactive, open-source Islamic quiz game designed to enrich religious knowledge in a fun and engaging way. The game is built to run efficiently across all operating systems, with a strong focus on accessibility to ensure an inclusive experience for everyone, including blind and visually impaired users.
IlmQuiz هي لعبة مسابقات ثقافية إسلامية تفاعلية ومفتوحة المصدر، تهدف إلى إثراء المعرفة الدينية بطريقة ممتعة وشيقة. تم تصميم اللعبة لتعمل على جميع أنظمة التشغيل بكفاءة عالية، مع التركيز الاستثنائي على إمكانية الوصول (Accessibility) لضمان تجربة لعب شاملة للجميع، بما في ذلك المكفوفين وضعاف البصر.
TTS مخصص:
UniversalSpeech (NVDA, JAWS, SAPI).VoiceOver عبر appscript و osascript.Orca و Speech-Dispatcher.QStackedWidget لانتقالات سريعة.
اللعبة متاحة للتحميل مجاناً لجميع أنظمة التشغيل (نسخ تثبيت ونسخ محمولة). يمكنك تحميل أحدث إصدار من صفحة الإصدارات (Releases).
IlmQuiz_Setup_vX.X.X.exe (تثبيت) أو IlmQuiz_Windows_Portable.zip (محمولة)IlmQuiz_macOS_Installer.dmg (تثبيت) أو (محمولة)IlmQuiz_macOS_Portable.zipIlmQuiz_Linux_Installer.deb (تثبيت) أو IlmQuiz_Linux_Portable.tar.gz (محمولة)تم بناء المشروع باستخدام لغة Python وإطار عمل PySide6.
git clone https://github.com/MesterPerfect/IlmQuiz.git
cd IlmQuiz
python -m venv venv
# Windows:
venv\Scripts\activate
# macOS / Linux:
source venv/bin/activate
pip install -r requirements.txt
python main.py
يعتمد المشروع على معمارية الطبقات لضمان نظافة الكود (Clean Code):
core/: يحتوي على محرك اللعبة الأساسي (GameEngine) وإدارة الحالة وإعدادات المسارات الثابتة.data/: يتعامل مع قاعدة بيانات SQLite ويحتوي على النماذج (Models) ونظام الـ Queries السريع.services/: يحتوي على الخدمات المنفصلة (نظام التحديثات، نظام تحويل النص لكلام TTS، الصوتيات، وإدارة الإعدادات).ui/: يحتوي على نوافذ الواجهة (Windows)، المكونات المشتركة، والتأثيرات البصرية، ونموذج العرض (GameViewModel).apply_update.py: سكربت خارجي مستقل لإدارة الكتابة فوق الملفات أثناء التحديث التلقائي.يستخدم المشروع GitHub Actions مع مكتبة cx_Freeze و Inno Setup لعملية البناء المؤتمتة.
بمجرد رفع كود جديد إلى فرع release، ستقوم خوادم GitHub ببناء وإنتاج 6 ملفات مختلفة (نسخ تثبيت ونسخ محمولة للأنظمة الثلاثة) ورفعها تلقائياً.
نرحب بجميع المساهمات! سواء كان ذلك بإصلاح أخطاء، تحسين الأداء، إضافة أسئلة جديدة، أو تحسين دعم قارئات الشاشة.
git checkout -b feature/AmazingFeature).git commit -m 'Add some AmazingFeature').git push origin feature/AmazingFeature).هذا المشروع مفتوح المصدر. جميع الحقوق محفوظة © 2026 لـ MesterPerfect. نسأل الله أن يجعل هذا العمل خالصاً لوجهه الكريم وأن ينفع به.