📖 دليل استخدام تطبيق دكسولوجي الشامل

🌟 لماذا دكسولوجي؟

• شامل ومتكامل: كل ما تحتاجه في مكان واحد - ترانيم، كتاب مقدس، برامج عبادة، عرض متعدد الشاشات، وتنبيهات
• قاعدة بيانات ضخمة: أكثر من 10,000 ترنيمة مرتبة ومنظمة مع إمكانية إضافة قواعد بيانات مخصصة
• سهل الاستخدام: واجهة عربية بديهية مع دعم كامل للاختصارات والتنقل السريع
• عرض احترافي: دعم شاشات متعددة مع تصميم عرض جميل ومتزامن تلقائياً
• إدارة ذكية: نظام قوي لإدارة الترانيم وقواعد البيانات والبحث عن المكررات
• تنبيهات مرنة: نظام تنبيهات متقدم مع قوالب جاهزة وتخصيص كامل
• كروما وفيديو: دعم الكروما (الشاشة الخضراء) ومصادر الفيديو المباشرة
• خلفيات مخصصة: التحكم الكامل في خلفية العرض مع دعم الصور والألوان
• تحديثات تلقائية: نظام تحديث ذكي للتطبيق وقواعد البيانات

📦 الميزات الرئيسية

• 📖 الكتاب المقدس الكامل: 66 سفر مع بحث متقدم ودعم المراجع المباشرة
• 🎵 قاعدة بيانات ترانيم ضخمة: أكثر من 10,000 ترنيمة + ترانيم مدرسة الأحد + نظم المزامير
• 📋 برامج عبادة متعددة: إدارة حتى 12 برنامج عبادة متزامن
• 🖥️ عرض متعدد الشاشات: دعم كامل للشاشات المتعددة (جمهور، فريق، إلخ) مع مزامنة تلقائية
• 🔔 نظام تنبيهات متقدم: قوالب جاهزة + تخصيص كامل + اختصارات سريعة
• 🔍 بحث ذكي: بحث سريع في الترانيم والآيات مع تجاهل التشكيل
• ✏️ محرر ترانيم قوي: إضافة وتعديل الترانيم مع دعم القرار والمفاتيح الموسيقية
• 💾 إدارة قواعد البيانات: إنشاء، استيراد، تصدير، ودمج قواعد البيانات
• 🔄 كشف المكررات: أداة ذكية للبحث عن الترانيم المكررة ومعالجتها
• 👁️ معاينة مباشرة: عمود معاينة لرؤية ما يظهر على الشاشات
• ⌨️ اختصارات شاملة: دعم كامل لاختصارات لوحة المفاتيح لجميع الوظائف
• 🟢 كروما (Chroma Key): دعم الشاشة الخضراء للبث المباشر والإسقاط
• 🎬 مصادر الفيديو: عرض الفيديو من الكاميرا أو مصادر خارجية
• 🖼️ خلفيات مخصصة: التحكم الكامل في خلفية العرض بالصور والألوان
• 🔄 تحديثات ذكية: نظام تحديث تلقائي للتطبيق وقواعد البيانات
• 📤 تصدير واستيراد البرامج: مشاركة برامج العبادة بصيغة JSON
• 🎮 أجهزة التحكم عن بُعد: دعم Logitech R400 وأجهزة العرض

1️⃣ شريط القوائم العلوي (Menu Bar)

يحتوي على القوائم الرئيسية:

• إعدادات:
  • الشاشات: اختيار الشاشات، خلفية شاشة الجمهور، إظهار الساعة (شاشة الجمهور/الفريق)، إظهار شريط الخلايا (شاشة الجمهور)
  • الكروما والفيديو: عرض الكروما، اختيار مصدر الفيديو، تشغيل/إغلاق الفيديو
  • إخفاء/إظهار شريط الاختصارات، إظهار/إخفاء المعاينة
  • تحميل الترانيم عند بدء التشغيل، عرض التلميحات للمستخدمين الجدد
• إدارة الترانيم: إضافة ترنيمة، تعديل ترنيمة، حذف ترنيمة، فتح نافذة إدارة الترانيم
• التنبيهات: تحرير وعرض التنبيهات
• مساعدة: دليل الاستخدام، فحص تحديث قواعد البيانات، فحص تحديث التطبيق، التسجيل والتفعيل، حول التطبيق

2️⃣ منطقة المحتوى الرئيسية (المنتصف)

تحتوي على التبويبات الرئيسية:

• 📖 الكتاب المقدس: تصفح وبحث في الكتاب المقدس
• 🎵 الترانيم: تصفح وبحث في الترانيم
• ✏️ إدارة الترانيم: إضافة وتعديل وحذف الترانيم
• 📋 برنامج العبادة: إدارة برامج العبادة
• 👨‍🏫 مدرسة الأحد: ترانيم مدرسة الأحد (قاعدة بيانات منفصلة)

3️⃣ عمود المعاينة (اليسار - اختياري)

يعرض معاينة مباشرة لما يظهر على الشاشات مع:

• معاينة شاشة الجمهور
• معاينة شاشة الفريق
• أزرار التحكم (تالي، سابق، شاشة سوداء)
• تنبيهات مخصصة (ملء الشاشة) — أزرار سريعة (1-4)
• عناوين سفلية سريعة (اسم المتكلم، الخدمة، إعلان عابر...)
• إدارة التنبيهات

يمكن إظهار/إخفاء هذا العمود بالضغط على Ctrl+P

📖 شاشة الكتاب المقدس

هذه الشاشة مخصصة لتصفح الكتاب المقدس، البحث في الآيات، وإضافة الشواهد لبرنامج العبادة.

🔍 طرق البحث والتصفح

1. التصفح بالسفر والإصحاح

الطريقة التقليدية للتصفح:

• اختر السفر من القائمة المنسدلة الأولى (66 سفر متاحة)
• اختر الإصحاح من القائمة المنسدلة الثانية
• ستظهر جميع آيات الإصحاح المختار تلقائياً في القائمة
• انقر على أي آية لمعاينتها

2. إدخال المرجع المباشر

أسرع طريقة للوصول لشاهد معين:

• اكتب المرجع مباشرة في حقل البحث بصيغة: "اسم السفر الإصحاح:الآيات"
• أمثلة صحيحة:
  • "يوحنا 3:16" - آية واحدة
  • "متى 5:1-10" - مجموعة آيات
  • "مزمور 23" - إصحاح كامل
  • "يو 3:16" - باستخدام الاختصار
• التطبيق يدعم اختصارات الأسفار (مثل "يو" ليوحنا، "مت" لمتى، إلخ)
• Enter — إضافة الشاهد وعرضه فوراً على الشاشات
• Ctrl+Enter — إضافة الشاهد لبرنامج العبادة فقط دون عرض

3. البحث في النص

للبحث عن كلمة أو عبارة في الكتاب المقدس:

• اكتب الكلمة أو العبارة في حقل البحث
• النتائج تظهر فوراً مع اسم السفر والإصحاح ورقم الآية
• انقر على أي نتيجة لعرض الآية كاملة
• البحث يتجاهل التشكيل والحركات للبحث الأمثل

➕ إضافة شاهد لبرنامج العبادة

يمكنك إضافة الشواهد الكتابية لبرنامج العبادة بعدة طرق:

• من حقل الشاهد (تبويب الترانيم): اكتب المرجع ثم Enter للإضافة والعرض فوراً، أو Ctrl+Enter للإضافة فقط
• من قائمة الآيات: حدد الآيات التي تريدها ثم اضغط زر "إضافة لبرنامج العبادة"
• النقر المزدوج: انقر نقرتين سريعتين على آية لإضافتها مباشرة

🎬 العرض المباشر

يمكنك عرض الشاهد مباشرة على الشاشات:

• حدد الآيات التي تريد عرضها
• اضغط زر "عرض" أو F2
• سيظهر الشاهد على جميع الشاشات المختارة

🎵 شاشة الترانيم

الشاشة الأساسية للبحث عن الترانيم، معاينتها، وإضافتها لبرنامج العبادة أو عرضها مباشرة.

🔍 البحث في الترانيم

نظام بحث قوي ومرن:

• البحث في العنوان: اكتب جزء من عنوان الترنيمة
• البحث في المحتوى: اكتب كلمة من كلمات الترنيمة
• البحث الذكي: يتجاهل التشكيل والحركات تلقائياً
• فوري: النتائج تظهر فوراً أثناء الكتابة

📊 اختيار قاعدة البيانات

يمكنك البحث في قواعد بيانات مختلفة:

• الكل: البحث في جميع قواعد البيانات المتاحة
• all_hymns.json: قاعدة البيانات الرئيسية (10,000+ ترنيمة)
• psalms.json: ترانيم نظم المزامير
• sunday_school.json: ترانيم مدارس الأحد
• قواعد بيانات مخصصة: أي قواعد بيانات أنشأتها بنفسك

🔢 الترتيب والفرز

يمكنك ترتيب نتائج البحث:

• تصاعدي (أ-ي): اضغط زر الترتيب مرة واحدة
• تنازلي (ي-أ): اضغط زر الترتيب مرة أخرى
• الترتيب الافتراضي: اضغط زر الترتيب مرة ثالثة

👁️ معاينة الترنيمة

عند اختيار ترنيمة من القائمة:

• تظهر معاينة كاملة للترنيمة في الجزء الأيمن
• يمكنك رؤية العنوان، الأعداد، والقرار
• الأعداد مرقمة تلقائياً (1، 2، إلخ) - يمكنك استخدام (xx) أو [xx] في البداية عند الكتابة
• القرار مميز بلون مختلف وموضعه محدد
• المفتاح الموسيقي معروض (إن وجد)

➕ إضافة الترنيمة وعرضها

في قائمة الترانيم:

• النقر العادي: يعرض الترنيمة فوراً ويضيفها لبرنامج العبادة
• Shift+Click: يضيف الترنيمة لبرنامج العبادة فقط دون عرضها

طرق أخرى:

• زر "إضافة لبرنامج العبادة": في أسفل معاينة الترنيمة
• قائمة السياق: انقر بزر الماوس الأيمن واختر "إضافة لبرنامج العبادة"
• النقر العادي يعرض ويضيف في خطوة واحدة — أسرع طريقة!

✏️ تعديل أو حذف ترنيمة

من معاينة الترنيمة، يمكنك:

• تعديل: زر "تعديل" أو Ctrl+E - يفتح محرر الترانيم
• حذف: زر "حذف" أو Delete - بعد تأكيد الحذف

✏️ شاشة إدارة الترانيم

محرر قوي لإضافة وتعديل الترانيم مع دعم كامل لجميع الخصائص.

➕ إضافة ترنيمة جديدة

خطوات إضافة ترنيمة:

1. اذهب إلى تبويب "إدارة الترانيم"
2. اضغط زر "إضافة ترنيمة"
3. املأ الحقول المطلوبة:
   • العنوان: عنوان الترنيمة (مطلوب)
   • الأعداد والقرار: اكتب نص الترنيمة في حقل واحد:
     • ابدأ كل عدد برقم بين أقواس: (1)، (2)، إلخ
     • لكتابة القرار، ابدأ السطر بـ (ق)
     • موضع القرار يُحدد تلقائياً حسب مكان كتابته في النص
     • ضع سطراً فارغاً داخل العدد لتقسيمه إلى شرائح
   • المفتاح الموسيقي (اختياري): مثل C#/Db أو Am
4. اختر قاعدة البيانات لحفظ الترنيمة
5. اضغط Ctrl+S أو زر "حفظ"

🔄 تعديل ترنيمة موجودة

خطوات التعديل:

1. ابحث عن الترنيمة في قائمة الترانيم على اليمين
2. اضغط على الترنيمة لتحميلها في المحرر
3. عدّل المعلومات المطلوبة — زر الحفظ يُفعَّل تلقائياً عند التعديل
4. اضغط Ctrl+S أو زر "حفظ"

📝 القرار (Chorus)

القرار يُكتب في نفس حقل الأعداد باستخدام (ق):

• في البداية: اكتب (ق) قبل العدد الأول — يظهر القرار في بداية الترنيمة
• بعد العدد الأول: اكتب (ق) بعد العدد الأول — يتكرر القرار بعد كل عدد
• بدون قرار: لا تكتب (ق) إطلاقاً

🗑️ حذف ترنيمة

لحذف ترنيمة:

• اختر الترنيمة من القائمة
• اضغط زر "حذف"
• تأكد من الحذف في رسالة التأكيد

يتم الحذف من قاعدة البيانات المصدر فقط.

🎯 المفتاح الموسيقي

يمكنك تحديد المفتاح الموسيقي للترنيمة:

• المفتاح يظهر على شاشات العرض (جمهور وفريق)
• انقر على المفتاح الموسيقي في معاينة الترنيمة لتعيينه أو تغييره مباشرة من قائمة منسدلة
• مفيد لقائد الترنيم ولأعضاء فريق الترانيم

💾 الحفظ وقواعد البيانات

• التزامن التلقائي: عند فتح ترنيمة، القوائم المنسدلة تتزامن مع قاعدة البيانات المصدر
• نقل بين القواعد: غيّر قاعدة البيانات المستهدفة لنقل الترنيمة عند الحفظ
• زر الحفظ: يُفعَّل تلقائياً عند تعديل أي حقل
• الإدخال المستمر: بعد حفظ ترنيمة جديدة، يُفرَّغ النموذج ويمكنك إدخال ترنيمة أخرى فوراً

📋 شاشة برنامج العبادة

الشاشة المركزية لإدارة برامج العبادة، ترتيب العناصر، وعرضها على الشاشات.

📝 إنشاء برنامج عبادة جديد

خطوات الإنشاء:

• اضغط Ctrl+N أو اذهب إلى قائمة ملف » برنامج جديد
• أدخل اسم البرنامج (مثل: "برنامج الأحد 15 ديسمبر")
• سيتم إنشاء برنامج فارغ جاهز لإضافة العناصر
• البرنامج الجديد يصبح البرنامج النشط تلقائياً

🔄 التبديل بين البرامج

يدعم التطبيق حتى 12 برنامج عبادة متزامن:

• استخدم القائمة المنسدلة في الأعلى لاختيار البرنامج
• أو استخدم Ctrl+O لفتح قائمة البرامج
• كل برنامج محفوظ بشكل مستقل
• يمكنك إنشاء برنامج لكل اجتماع أو خدمة

➕ إضافة عناصر للبرنامج

يمكنك إضافة عناصر مختلفة:

• ترانيم: من تبويب "الترانيم" أو "مدرسة الأحد"
• شواهد كتابية: من تبويب "الكتاب المقدس"
• جميع العناصر تظهر في قائمة البرنامج مع رمز مميز (🎵 للترانيم، 📖 للشواهد)

🔀 ترتيب العناصر

يمكنك ترتيب عناصر البرنامج بسهولة:

• الأسهم: استخدم أزرار ↑ و ↓ بجانب كل عنصر
• السحب والإفلات: اسحب العنصر وأفلته في المكان المطلوب (Drag & Drop)
• التغييرات تلقائية: الترتيب يُحفظ فوراً

📤 تصدير واستيراد البرنامج

يمكنك مشاركة برامج العبادة:

• تصدير: من قائمة ملف » تصدير البرنامج - يحفظ البرنامج كملف JSON
• استيراد: من قائمة ملف » استيراد برنامج - يستورد من ملف JSON
• المشاركة: أرسل ملف JSON لشخص آخر يستخدم التطبيق

🗑️ حذف عناصر من البرنامج

• حدد العنصر المطلوب حذفه
• اضغط زر "حذف" أو Delete
• أو استخدم زر ❌ بجانب العنصر

💾 حفظ البرامج

الحفظ يتم تلقائياً، لكن يمكنك أيضاً:

• حفظ: Ctrl+S - حفظ التغييرات للبرنامج الحالي
• حفظ باسم: Ctrl+Shift+S - حفظ نسخة من البرنامج باسم جديد

🎬 عرض البرنامج

لعرض عناصر البرنامج:

• حدد العنصر الذي تريد عرضه
• اضغط F2 أو Alt+P
• أو انقر على عنصر في برنامج العبادة للعرض الفوري
• سيظهر العنصر على جميع الشاشات المختارة
• استخدم الأسهم للتنقل بين العناصر

👨‍🏫 شاشة مدرسة الأحد

قاعدة بيانات منفصلة للترانيم الخاصة بمدرسة الأحد والأطفال.

📚 ما هي ترانيم مدرسة الأحد؟

• ترانيم بسيطة ومناسبة للأطفال
• محفوظة في قاعدة بيانات منفصلة (sunday_school.json)
• يمكن البحث فيها مثل الترانيم العادية تماماً
• يمكن إضافتها لبرنامج العبادة أو عرضها مباشرة

🔍 البحث والاستخدام

تعمل شاشة مدرسة الأحد بنفس طريقة شاشة الترانيم:

• البحث في العنوان أو المحتوى
• معاينة الترنيمة
• إضافة لبرنامج العبادة
• عرض مباشر
• تعديل أو حذف

➕ إضافة ترانيم جديدة

يمكنك إضافة ترانيم جديدة لمدرسة الأحد:

• استخدم نفس محرر الترانيم العادي
• اختر قاعدة بيانات "sunday_school" عند الحفظ
• ستظهر الترنيمة في تبويب مدرسة الأحد

📝 إنشاء وإدارة البرامج

💼 أنواع البرامج

يمكنك إنشاء برامج عبادة لمختلف الاجتماعات:

• 🕊️ برنامج اجتماع العبادة
• 🌅 برنامج اجتماع الصلاة
• 📚 برنامج مدرسة الأحد
• ⛪ برنامج اجتماع الشباب
• 🎵 برنامج التسبيح والعبادة
• 🎭 برنامج مناسبة خاصة

🎯 أفضل الممارسات

• استخدم أسماء وصفية: مثل "العبادة العامة" بدلاً من "برنامج 1"
• جهز مسبقاً: أنشئ البرنامج قبل الاجتماع بوقت كافٍ
• اختبر العرض: جرب عرض البرنامج قبل الاجتماع للتأكد من كل شيء
• احتفظ بنسخ احتياطية: استخدم "حفظ باسم" لإنشاء نسخ احتياطية

🔄 إدارة البرامج المتعددة

📊 الحد الأقصى

التطبيق يدعم حتى 12 برنامج عبادة متزامن.

🔀 التبديل السريع

• استخدم القائمة المنسدلة في الأعلى
• أو Ctrl+O لفتح قائمة البرامج
• البرنامج النشط مميز بعلامة ✓

🗑️ حذف برنامج

• من قائمة البرامج، اختر البرنامج
• اضغط زر "حذف البرنامج"
• تأكيد الحذف (الحذف نهائي)

📋 نسخ برنامج

• افتح البرنامج الذي تريد نسخه
• استخدم Ctrl+Shift+S "حفظ باسم"
• أدخل اسم جديد للنسخة

📦 عناصر البرنامج

🎵 الترانيم

• تظهر برمز 🎵 في القائمة
• تعرض العنوان والمفتاح الموسيقي (إن وجد)
• عند العرض، تُبنى الشرائح تلقائياً حسب الأعداد والقرار

📖 الشواهد الكتابية

• تظهر برمز 📖 في القائمة
• تعرض المرجع (مثل: يوحنا 3:16)
• عند العرض، تُبنى الشرائح بآية واحدة لكل شريحة

🔢 ترقيم تلقائي

العناصر مرقمة تلقائياً (1، 2، 3، ...) لسهولة التنقل والتنظيم.

🖥️ اختيار وإعداد الشاشات

🔍 اكتشاف الشاشات

• التطبيق يكتشف تلقائياً جميع الشاشات المتصلة بالحاسوب
• يعرض معلومات كل شاشة (الحجم، الدقة، الموضع)
• يحدد الشاشة الرئيسية تلقائياً

⚙️ فتح نافذة اختيار الشاشات

• اضغط Ctrl+D
• أو اذهب إلى قائمة عرض » اختيار الشاشات
• ستظهر نافذة بجميع الشاشات المتاحة

🎯 أنواع الشاشات

لكل شاشة، يمكنك تحديد نوعها:

• 👥 جمهور (Audience): للعرض على الجمهور - شرائح نصية عادية
• 🎵 فريق (Choir): للعرض على فريق الترانيم - تخطيط 3 أعمدة مع الشرائح القادمة
• ❌ غير محدد: لا تستخدم هذه الشاشة

💾 حفظ الإعدادات

• الإعدادات تُحفظ تلقائياً فور تحديدها
• ستستخدم نفس الإعدادات في المرة القادمة
• يمكنك تغيير الإعدادات في أي وقت

👥 شاشة الجمهور - التفاصيل الكاملة

شاشة مصممة بعناية لعرض محتوى واضح وجميل للجمهور.

📐 تخطيط الشاشة

• في الأعلى:
  • 🕐 ساعة رقمية في الركن الأيمن (الوقت الحالي) — يمكن إخفاؤها من إعدادات → الشاشات
• في المنتصف:
  • 🎵 العنوان: عنوان الترنيمة أو اسم السفر (بخط كبير وواضح)
  • 📄 المحتوى: نص الترنيمة أو الآيات (بخط واضح ومريح للقراءة)
• في الأسفل:
  • 📖 الشاهد الكتابي في الركن الأيسر السفلي (للشواهد الكتابية فقط)
  • 🎼 المفتاح الموسيقي على اليمين (إن وجد)
  • 📊 شريط الشرائح (الخلايا): عرض جميع الشرائح مع تمييز الشريحة الحالية — يمكن إخفاؤه من إعدادات → الشاشات

🎨 التصميم

• خلفية زرقاء متدرجة جميلة (#081F4E)
• نص أبيض واضح مع ظلال لسهولة القراءة
• خطوط كبيرة (28-48pt) حسب طول النص
• تباين عالٍ لرؤية واضحة من بعيد

📋 شريط الشرائح (شريط الخلايا)

• يعرض جميع شرائح الترنيمة/الشاهد
• الشريحة الحالية مميزة بلون أزرق فاتح
• الشرائح الأخرى باللون الرمادي
• مفيد للمتابعة ومعرفة الموضع الحالي
• يمكن إظهار/إخفاء الشريط من إعدادات → الشاشات → إظهار شريط الخلايا - شاشة الجمهور

⚙️ تخصيص عناصر الشاشة

من قائمة إعدادات → الشاشات يمكنك:

• إظهار الساعة - شاشة الجمهور: إظهار أو إخفاء الساعة الرقمية في شاشة الجمهور
• إظهار الساعة - شاشة الفريق: إظهار أو إخفاء الساعة في شاشة الفريق
• إظهار شريط الخلايا - شاشة الجمهور: إظهار أو إخفاء شريط الشرائح في أسفل الشاشة

🎵 شاشة الفريق - التفاصيل الكاملة

شاشة مصممة خصيصاً لفريق الترانيم لعرض المحتوى الحالي والقادم مع برنامج العبادة.

📐 تخطيط 3 أعمدة (غير متساوية)

الشاشة مقسمة إلى 3 أعمدة بنسب مختلفة (20% - 60% - 20%):

العمود الأيمن (20%) — المحتوى القادم

مقسّم عمودياً إلى خليتين:

• الخلية العليا: الشريحة التالية (نص رمادي بخط كبير) — ليرى قائد الترنيم ما سيظهر بعد قليل
• الخلية السفلى: عنوان الترنيمة/العنصر القادم (بلون أزرق فاتح) + أول شريحتين منه (نص رمادي)

العمود الأوسط (60%) — الشريحة الحالية

• يعرض الشريحة الحالية بخط كبير واضح (نص أبيض كامل الوضوح)
• يدعم الشاشة السوداء للعمود الأوسط فقط (بينما يبقى العمودان الجانبيان ظاهرين)

العمود الأيسر (20%) — برنامج العبادة

• عنوان "برنامج العبادة" في الأعلى
• قائمة العناصر: جميع عناصر برنامج العبادة مع تمييز العنصر النشط بخلفية مختلفة
• يتزامن تلقائياً مع العرض — العنصر المعروض حالياً يظهر مميزاً

⭐ عناصر إضافية (عائمة)

• 🕒 الساعة الرقمية: في أعلى الشاشة — يمكن إخفاؤها من إعدادات → الشاشات
• 🎼 المفتاح الموسيقي: في أسفل الشاشة على اليمين (إن وُجد)
• 📊 شريط الشرائح: في أسفل الشاشة — يعرض جميع الشرائح مع تمييز الحالية

🎯 الفائدة

• قائد الترنيم يرى الشريحة الحالية + التالية + الترنيمة القادمة في نفس الوقت
• معرفة ترتيب برنامج العبادة كاملاً من الشاشة مباشرة
• الفريق يعرف متى يغير النغمة أو ينتقل للقرار
• تحسين التنسيق بين أعضاء الفريق وتقليل الأخطاء

🎨 التصميم

• خلفية داكنة (#0A0E14) لجميع الأعمدة
• حدود واضحة بين الأعمدة
• النص الرئيسي أبيض كامل الوضوح، النصوص الجانبية رمادية
• الساعة الرقمية في الأعلى + المفتاح الموسيقي في الأسفل

🎮 التحكم في العرض

▶️ بدء العرض

عدة طرق لبدء العرض:

• من معاينة الترنيمة/الشاهد: زر "عرض"
• من برنامج العبادة: حدد العنصر واضغط F2 أو Alt+P
• من لوحة المفاتيح: F2 في أي مكان

⏭️ التنقل بين الشرائح

المفتاح	الوظيفة
→ أو Enter	الشريحة التالية
← أو Backspace	الشريحة السابقة
↑ / ↓	الشريحة السابقة / التالية
Page Up / Page Down	الشريحة السابقة / التالية
Home	الشريحة الأولى
End	الشريحة الأخيرة
Ctrl+End	توسيع الشاهد الكتابي حتى نهاية الإصحاح
Ctrl+Home	توسيع الشاهد الكتابي حتى بداية الإصحاح
0-9	الانتقال لعدد/آية محددة
+ / -	تكبير / تصغير حجم الخط أثناء العرض

⬛ الشاشة السوداء

• اضغط F3 أو B
• الشاشة تصبح سوداء تماماً
• مفيد عند الانتقال بين فقرات أو عند الحديث
• اضغط مرة أخرى لإعادة العرض

⏸️ إيقاف العرض

• اضغط F4 لإغلاق جميع نوافذ العرض
• اضغط Escape لإغلاق نوافذ العرض
• أو أغلق النوافذ يدوياً

🔄 المزامنة

جميع الشاشات متزامنة تلقائياً:

• عند الانتقال لشريحة، تتغير جميع الشاشات معاً
• الشاشة السوداء تطبق على جميع الشاشات
• لا حاجة لتحكم منفصل لكل شاشة

➕ إنشاء تنبيه جديد

🚀 فتح محرر التنبيهات

• اضغط Ctrl+A
• أو اذهب إلى قائمة أدوات » التنبيهات
• أو من عمود المعاينة، اضغط زر "إدارة التنبيهات"

📝 محتوى التنبيه

• العنوان (اختياري): عنوان التنبيه
• النص الرئيسي: محتوى التنبيه
• نص إضافي (اختياري): نص توضيحي إضافي

🎨 التخصيص

الخاصية	الوصف
لون الخلفية	اختر من 10 ألوان جاهزة أو استخدم لون مخصص
لون النص	لون النص الرئيسي والعنوان
حجم الخط	صغير، متوسط، كبير، أو حجم مخصص (12-200pt)
نوع الخط	اختر من عدة خطوط عربية وإنجليزية
صورة الخلفية	أضف صورة خلفية (اختياري)
التأثير الحركي	Fade، Slide، Pulse، أو بدون تأثير

🖥️ اختيار الشاشات

• حدد الشاشات التي تريد عرض التنبيه عليها
• يمكنك اختيار شاشة واحدة أو عدة شاشات
• يمكنك تحديد نوع الشاشة (جمهور، فريق، أو كليهما)

⏱️ المدة

• مدة العرض: عدد الثواني (1-300)
• إغلاق تلقائي: يُغلق التنبيه تلقائياً بعد المدة المحددة
• إغلاق يدوي: يبقى التنبيه حتى تضغط Escape

👁️ المعاينة والعرض

• معاينة: زر "معاينة" لعرض التنبيه على شاشة واحدة للاختبار
• عرض: زر "عرض" لعرض التنبيه على جميع الشاشات المحددة

📋 القوالب الجاهزة

التطبيق يوفر قوالب جاهزة للاستخدام السريع:

1️⃣ ترحيب (Welcome)

• العنوان: "أهلاً وسهلاً"
• النص: "نرحب بكم في اجتماع اليوم"
• الألوان: خلفية زرقاء، نص أبيض
• الاستخدام: للترحيب بالحضور في بداية الاجتماع

2️⃣ صلاة (Prayer)

• العنوان: "وقت الصلاة"
• النص: "فلنصلي معاً"
• الألوان: خلفية خضراء، نص أبيض
• الاستخدام: للإعلان عن وقت الصلاة

3️⃣ تنبيه للمتكلم (Speaker Alert)

• العنوان: "تنبيه"
• النص: "رسالة هامة"
• الألوان: خلفية برتقالية، نص أسود
• الاستخدام: للإعلانات الهامة

4️⃣ استراحة (Break)

• العنوان: "استراحة"
• النص: "سنعود بعد قليل"
• الألوان: خلفية رمادية، نص أبيض
• الاستخدام: لإعلان الاستراحة

5️⃣ مخصص (Custom)

• قالب فارغ للتخصيص الكامل
• يمكنك تعديل جميع الخصائص

⚡ تنبيهات مخصصة (ملء الشاشة)

ميزة قوية لعرض تنبيهات محفوظة بنقرة زر واحدة!

📌 ما هي الاختصارات؟

• يمكنك حفظ حتى 4 تنبيهات كاختصارات سريعة
• تظهر كأزرار في عمود المعاينة (1، 2، 3، 4)
• نقرة واحدة لعرض التنبيه على الشاشات
• مثالية للتنبيهات المتكررة

➕ إضافة اختصار

1. أنشئ تنبيهاً وخصصه كما تريد
2. في محرر التنبيهات، ستجد قسم "تنبيهات مخصصة (ملء الشاشة)"
3. اختر رقم الاختصار (1-4) من القائمة المنسدلة
4. حدد التنبيه الحالي للاختصار
5. اضغط "حفظ" - سيظهر الاختصار في عمود المعاينة

🎯 استخدام الاختصارات

• اذهب إلى عمود المعاينة
• اضغط على الزر المرقم (1، 2، 3، أو 4)
• سيُعرض التنبيه فوراً على الشاشات

✏️ تعديل اختصار

• افتح محرر التنبيهات
• اختر الاختصار من القائمة المنسدلة
• عدّل التنبيه كما تريد
• احفظ التغييرات

🗑️ حذف اختصار

• في محرر التنبيهات، اختر "-- غير محدد --" للاختصار
• احفظ - سيُحذف الاختصار

➕ إضافة ترانيم - الخطوات التفصيلية

📝 الحقول المطلوبة

• العنوان (مطلوب): عنوان الترنيمة
• الأعداد (مطلوب): محتوى الترنيمة

📋 الحقول الاختيارية

• القرار: يُكتب في نفس حقل الأعداد باستخدام (ق) في بداية السطر
• المفتاح الموسيقي: مثل C#/Db أو Am
• قاعدة البيانات: اختر القاعدة لحفظ الترنيمة

✍️ كتابة الأعداد

يمكنك كتابة الأعداد بطريقتين:

الطريقة 1: استخدام الترقيم في البداية (موصى به)

ابدأ كل عدد برقم بين أقواس في البداية فقط:

(1) هذا هو العدد الأول
سطر ثاني من العدد الأول

(2) هذا هو العدد الثاني
سطر ثاني من العدد الثاني

(3) هذا هو العدد الثالث
                    

أو باستخدام الأقواس المربعة:

[1] هذا هو العدد الأول
سطر ثاني من العدد الأول

[2] هذا هو العدد الثاني
سطر ثاني من العدد الثاني

[3] هذا هو العدد الثالث
                    

كتابة القرار مع الأعداد

اكتب (ق) في بداية سطر القرار. موضعه يحدد متى يظهر:

(1) هذا هو العدد الأول
سطر ثاني من العدد الأول

(ق) هذا هو القرار
سطر ثاني من القرار

(2) هذا هو العدد الثاني
سطر ثاني من العدد الثاني
                    

الطريقة 2: سطر فارغ بين الأعداد (بدون ترقيم)

يمكنك أيضاً كتابة الأعداد بدون ترقيم، وسيتم ترقيمها تلقائياً:

هذا هو العدد الأول
سطر ثاني من العدد الأول

هذا هو العدد الثاني
سطر ثاني من العدد الثاني

هذا هو العدد الثالث
                    

✏️ تعديل الترانيم

🔍 البحث عن الترنيمة

• اذهب إلى تبويب "إدارة الترانيم"
• ابحث عن الترنيمة بالعنوان أو المحتوى
• حدد الترنيمة من القائمة

✏️ فتح المحرر

• اضغط على الترنيمة في القائمة لتحميلها في المحرر
• عدّل المعلومات المطلوبة — زر الحفظ يُفعَّل تلقائياً عند أي تعديل
• احفظ بـ Ctrl+S أو زر "حفظ"

🔄 تغيير قاعدة البيانات

• في المحرر، اختر قاعدة بيانات مختلفة
• احفظ - ستُنقل الترنيمة لقاعدة البيانات الجديدة
• ستُحذف من قاعدة البيانات القديمة

🗑️ حذف الترانيم

⚠️ تحذير هام

🗑️ خطوات الحذف

• حدد الترنيمة من القائمة
• اضغط زر "حذف" أو Delete
• ستظهر رسالة تأكيد - اقرأها بعناية
• أكد الحذف - ستُحذف الترنيمة نهائياً

💡 البديل: النقل لقاعدة بيانات أرشيف

بدلاً من الحذف، يمكنك:

• إنشاء قاعدة بيانات "أرشيف"
• نقل الترانيم غير المستخدمة إليها
• تبقى الترانيم محفوظة للمستقبل

🎵 إدارة القرار - التفاصيل الكاملة

📖 ما هو القرار؟

القرار (Chorus) هو المقطع الذي يتكرر في الترنيمة. مثال:

العدد 1:
يا ربي أحبك من كل قلبي
وأرنم لك بكل فرح

القرار:
مجداً لك يا إلهي
مجداً لك يا ملكي

العدد 2:
أنت نوري وخلاصي
من أخشى ومن أخاف

القرار:
مجداً لك يا إلهي
مجداً لك يا ملكي
                    

📍 أنواع موضع القرار

1️⃣ بعد كل عدد (After Each)

• القرار يظهر بعد كل عدد من أعداد الترنيمة
• الترتيب: عدد 1 » قرار » عدد 2 » قرار » عدد 3 » قرار
• الاستخدام: الأكثر شيوعاً

2️⃣ في النهاية (At End)

• القرار يظهر مرة واحدة في نهاية الترنيمة
• الترتيب: عدد 1 » عدد 2 » عدد 3 » قرار
• الاستخدام: للترانيم ذات القرار الختامي

3️⃣ مخصص (Custom)

• أنت تحدد بعد أي أعداد يظهر القرار
• مرونة كاملة في التحكم
• الاستخدام: للأنماط غير القياسية

⚙️ كتابة الموضع المخصص

يمكنك استخدام عدة صيغ:

الصيغة	المعنى	مثال
أرقام مفردة	بعد الأعداد المحددة فقط	"1، 3، 5" = بعد أعداد 1 و 3 و 5
نطاق	بعد نطاق من الأعداد	"1-3" = بعد أعداد 1 و 2 و 3
مختلط	مزيج من الأرقام والنطاقات	"1، 3-5، 8" = بعد 1، 3، 4، 5، 8

🎬 القرار في العرض

• القرار مميز بلون مختلف على الشاشة
• يظهر بشكل واضح للجمهور والفريق
• شريط الشرائح يعرض جميع المقاطع بما فيها القرار

📊 العمليات على قواعد البيانات

🔧 الوصول إلى مدير قواعد البيانات

• من القائمة: إدارة » إدارة قواعد البيانات
• الاختصار: Ctrl+Shift+D

📁 إنشاء قاعدة بيانات جديدة

1. اضغط على زر "إنشاء قاعدة بيانات جديدة"
2. اختر اسم ومكان حفظ القاعدة
3. سيتم إنشاء قاعدة بيانات فارغة جاهزة للاستخدام

🔄 التبديل بين قواعد البيانات

• يمكنك العمل على عدة قواعد بيانات منفصلة
• كل قاعدة بيانات تحتفظ بترانيمها الخاصة
• مفيد لتصنيف الترانيم (ترانيم عامة، مدرسة أحد، مناسبات خاصة)

📤 الاستيراد والتصدير

📥 استيراد الترانيم

✨ استيراد من ملف JSON

1. اضغط على "استيراد من JSON"
2. اختر ملف JSON يحتوي على الترانيم
3. سيتم استيراد جميع الترانيم تلقائياً

📤 تصدير الترانيم

• احفظ نسخة احتياطية من جميع ترانيمك
• شارك ترانيمك مع الآخرين

🔍 إدارة الترانيم المكررة

🎯 البحث عن المكررات

التطبيق يساعدك في اكتشاف وإدارة الترانيم المتشابهة أو المكررة

⚙️ خيارات إدارة المكررات

• مقارنة جنباً إلى جنب: عرض الترنيمتين للمقارنة
• تنقل بين 3+ ترانيم: عند وجود أكثر من ترنيمتين في مجموعة، استخدم أزرار ◄ ► للتنقل مع عداد (مثل: 2 من 4)
• حذف نسخة: احذف إحدى النسخ المكررة
• دمج: ادمج المعلومات من كلتا النسختين
• تجاهل: احتفظ بكلتا النسختين

📍 الموقع والاستخدام

• الموقع: على يسار الشاشة الرئيسية
• العرض/الإخفاء: Ctrl+P أو من قائمة عرض
• الحجم: قابل للتعديل بسحب الحد الفاصل

✨ ماذا تعرض المعاينة؟

• الترانيم: عرض الترنيمة بالتنسيق الكامل
• الآيات الكتابية: معاينة النص مع المرجع
• التنبيهات: كيف ستظهر التنبيهات للجمهور
• برنامج العبادة: العنصر المحدد من البرنامج

📌 عناوين سفلية سريعة

عرض اسم المتكلم، عنوان الخدمة، إعلان عابر، أو أي نص قصير أسفل الشاشة دون الحاجة لشاشة كاملة كما في التنبيهات.

• الحقل الرئيسي: للنص على اليمين (مثل: اجتماع الصلاة والتسبيح)
• الحقل الثانوي: للنص على اليسار (مثل: اسم المتكلم)
• زر عرض: بجوار كل حقل لعرضه بشكل مستقل
• الشفافية والكروما: للتحكم في مظهر العناوين

⚡ قائمة الترانيم والعرض الفوري

في قائمة الترانيم، النقر على ترنيمة يعرضها ويضيفها لبرنامج العبادة فوراً!

🎯 قائمة الترانيم

• النقر العادي: يعرض الترنيمة فوراً على الشاشات ويضيفها لبرنامج العبادة
• Shift+Click: يضيف الترنيمة لبرنامج العبادة فقط دون عرضها

📋 برنامج العبادة

• النقر أو F2: على أي عنصر في برنامج العبادة — العرض الفوري

🖼️ إعدادات الخلفية

تحكم كامل في خلفية شاشات العرض.

🚀 فتح إعدادات الخلفية

• اضغط Ctrl+B
• أو اذهب إلى قائمة عرض » إعدادات الخلفية

🎨 خيارات الخلفية

• لون الخلفية: اختر لون خلفية مخصص بدلاً من الافتراضي
• صورة خلفية: اختر صورة لتظهر كخلفية على شاشات العرض
• تعتيم الصورة: التحكم في شفافية صورة الخلفية
• إعادة التعيين: الرجوع للخلفية الافتراضية

🟢 الكروما (Chroma Key Overlay)

ميزة احترافية لعرض النص على خلفية خضراء (أو أي لون) للاستخدام مع برامج البث المباشر مثل OBS Studio و VMix.

🎯 ما هي الكروما؟

الكروما (Chroma Key) هي تقنية تُستخدم في البث المباشر والإنتاج المرئي لإزالة لون معين من الصورة واستبداله بمحتوى آخر. في تطبيق دكسولوجي:

• تظهر نافذة منفصلة بخلفية ملونة (خضراء افتراضياً)
• يُعرض نص الترنيمة أو الآية الكتابية فوق هذه الخلفية
• يلتقط برنامج البث (OBS أو VMix) هذه النافذة ويُزيل اللون الأخضر
• النتيجة: يظهر نص الترانيم والآيات بشكل شفاف فوق بث الفيديو المباشر للكاميرا

🚀 تفعيل الكروما

• اضغط Ctrl+K لفتح نافذة إعدادات الكروما
• أو اضغط F5 لتبديل الكروما بسرعة (تشغيل/إيقاف)
• أو اذهب إلى قائمة عرض » الكروما

⚙️ إعدادات الكروما المتاحة

الإعداد	الوصف	القيمة الافتراضية
لون الكروما	اللون الذي سيُزال في برنامج البث	أخضر #00FF00
شفافية الخلفية	درجة وضوح لون الخلفية (0-255)	255 (معتم بالكامل)
حجم الخط	حجم نص العرض (20-120 بكسل)	48 بكسل
لون النص	لون كلمات الترانيم والآيات	أبيض
نوع الخط	الخط المستخدم للعرض	GE Jarida Heavy
خلفية النص	شريط شبه شفاف خلف النص لسهولة القراءة	معطّل

📡 الاستخدام مع OBS Studio & VMix

دليل شامل لاستخدام تطبيق دكسولوجي مع برامج البث المباشر الاحترافية OBS Studio و VMix لعرض كلمات الترانيم والآيات الكتابية فوق بث الفيديو المباشر.

💡 الفكرة الأساسية

عند بث اجتماعات الكنيسة عبر الإنترنت أو تسجيلها، تحتاج لعرض كلمات الترانيم والآيات الكتابية فوق صورة الكاميرا. يتم ذلك من خلال 3 خطوات بسيطة:

1. تفعيل الكروما في تطبيق دكسولوجي — تظهر نافذة بخلفية خضراء عليها النص
2. التقاط نافذة الكروما في برنامج البث (OBS أو VMix)
3. إضافة فلتر Chroma Key لإزالة اللون الأخضر — يبقى النص فقط فوق الفيديو

🎬 الإعداد في OBS Studio (خطوة بخطوة)

الخطوة 1: تفعيل الكروما في دكسولوجي

1. افتح تطبيق دكسولوجي
2. اضغط Ctrl+K لفتح إعدادات الكروما
3. تأكد أن لون الكروما هو الأخضر (#00FF00)
4. عدّل حجم الخط ولونه حسب رغبتك
5. اضغط F5 لتفعيل الكروما — ستظهر نافذة خضراء منفصلة

الخطوة 2: إضافة مصدر في OBS

1. افتح OBS Studio
2. في قسم Sources (المصادر)، اضغط زر +
3. اختر Window Capture (التقاط نافذة)
4. سمِّ المصدر (مثلاً: "كلمات الترانيم")
5. من قائمة Window، اختر نافذة الكروما الخاصة بدكسولوجي
6. فعّل خيار Capture Cursor: Off (إخفاء مؤشر الماوس)
7. اضغط OK

الخطوة 3: إضافة فلتر Chroma Key في OBS

1. اضغط بالزر الأيمن على مصدر نافذة الكروما في قائمة المصادر
2. اختر Filters (الفلاتر)
3. اضغط + في قسم Effect Filters
4. اختر Chroma Key
5. في Key Color Type: اختر Green
6. عدّل الإعدادات التالية حسب الحاجة:
   • Similarity (التشابه): ابدأ بقيمة 400، وارفعها إذا لم يُزال اللون بالكامل
   • Smoothness (النعومة): قيمة 80-120 تعطي حواف ناعمة للنص
   • Key Color Spill Reduction: قيمة 100 لإزالة أي انعكاس أخضر على النص
7. اضغط Close

الخطوة 4: ترتيب الطبقات في OBS

1. تأكد أن مصدر كلمات الترانيم (الكروما) موجود فوق مصدر الكاميرا في قائمة المصادر
2. يمكنك سحب المصدر لتغيير ترتيبه — الأعلى في القائمة يظهر في المقدمة
3. عدّل حجم وموقع طبقة النص على الشاشة بالسحب والتحجيم

🖥️ الإعداد في VMix (خطوة بخطوة)

الخطوة 1: تفعيل الكروما في دكسولوجي

نفس خطوات OBS أعلاه — فعّل الكروما بالضغط على F5 أو Ctrl+K.

الخطوة 2: إضافة Input في VMix

1. افتح VMix
2. اضغط Add Input في الأسفل
3. اختر Window / Screen Capture
4. من القائمة، اختر نافذة الكروما الخاصة بدكسولوجي
5. اضغط OK

الخطوة 3: إضافة Colour Key في VMix

1. اضغط على زر الإعدادات (الترس) على الـ Input الذي أضفته
2. اذهب إلى تبويب Colour Key
3. فعّل Colour Key بوضع علامة ✓
4. اختر اللون الأخضر باستخدام أداة القطّارة (Eyedropper) — انقر على المنطقة الخضراء
5. عدّل الإعدادات:
   • Tolerance (التسامح): ابدأ بقيمة 0.20 وعدّل حسب النتيجة
   • Softness (النعومة): قيمة 0.05-0.10 لحواف ناعمة
6. اضغط OK

الخطوة 4: استخدام كـ Overlay في VMix

1. اضغط على رقم Overlay (1-4) في أسفل نافذة VMix
2. اختر Input الكروما كـ Overlay
3. سيظهر النص الآن فوق أي مصدر فيديو نشط
4. يمكنك التحكم في الموقع والحجم من إعدادات Position في الـ Input

🖥️ الاستخدام مع شاشة واحدة فقط (بدون شاشات إضافية)

إذا كان جهازك يحتوي على شاشة واحدة فقط، لا تقلق! يمكنك استخدام الكروما مع OBS و VMix بالطرق التالية:

✅ الطريقة 1: Window Capture المتقدم في OBS (الطريقة المُوصى بها)

في الإصدارات الحديثة من OBS (على Windows 10 الإصدار 1903 فما فوق)، يمكن لـ Window Capture التقاط أي نافذة حتى لو كانت مخفية خلف نوافذ أخرى:

1. في OBS، أضف مصدر Window Capture
2. اختر نافذة الكروما الخاصة بدكسولوجي
3. في Capture Method (طريقة الالتقاط)، اختر:
   • Windows 10 (1903+) — هذه الطريقة تلتقط النافذة حتى لو كانت مغطاة بنوافذ أخرى أو مصغّرة
4. أضف فلتر Chroma Key كالمعتاد
5. الآن يمكنك التنقل بحرية بين التطبيقات دون أن يتأثر الالتقاط!

✅ الطريقة 2: سير العمل بشاشة واحدة

إذا لم تتوفر طريقة الالتقاط المتقدمة، اتبع هذا السير:

1. أولاً — جهّز كل شيء في OBS/VMix قبل بدء العرض:
   • أضف مصدر الكاميرا وهيّئ المشهد (Scene)
   • أضف مصدر Window Capture (ستختار نافذة الكروما لاحقاً)
   • أضف فلتر Chroma Key على المصدر
2. ثانياً — افتح دكسولوجي وفعّل الكروما:
   • اضغط Ctrl+K لضبط إعدادات الكروما
   • ابدأ عرض ترنيمة لتظهر نافذة العرض
   • اضغط F5 لتفعيل الكروما
3. ثالثاً — استخدم Alt+Tab للتبديل:
   • اضغط Alt+Tab للتنقل بين دكسولوجي و OBS/VMix
   • في OBS، اختر نافذة الكروما في مصدر Window Capture
   • ارجع لدكسولوجي بـ Alt+Tab للتحكم في العرض
4. رابعاً — ابدأ البث:
   • في OBS اضغط Start Streaming أو Start Recording
   • ارجع لدكسولوجي وتحكم في العرض كالمعتاد

✅ الطريقة 3: في VMix مع شاشة واحدة

1. في VMix، أضف Window Capture input
2. اختر نافذة الكروما — VMix يلتقط النافذة في الخلفية تلقائياً
3. أضف Colour Key كالمعتاد
4. استخدم Alt+Tab للتبديل بين VMix ودكسولوجي

✅ الطريقة 4: استخدام سطح المكتب الافتراضي (Windows 10/11)

حل أنيق لتنظيم مساحة العمل بشاشة واحدة:

1. اضغط Win+Ctrl+D لإنشاء سطح مكتب افتراضي جديد
2. ضع دكسولوجي ونافذة العرض على سطح المكتب الأول
3. ضع OBS/VMix على سطح المكتب الثاني
4. استخدم Win+Ctrl+→ أو Win+Ctrl+← للتبديل السريع بينهما
5. OBS يستمر في التقاط نافذة الكروما حتى عندما تكون على سطح مكتب آخر

💎 نصائح احترافية للحصول على أفضل نتيجة

• 🖥️ شاشتان أفضل لكن ليس شرطاً: إذا توفرت شاشة إضافية فهي مثالية، لكن يمكنك العمل بشاشة واحدة باستخدام الطرق المذكورة أعلاه
• 🎨 لا تستخدم اللون الأخضر في النص: تأكد أن لون النص مختلف تماماً عن لون الكروما (الأبيض أو الأصفر خيارات ممتازة)
• 📐 اجعل الشفافية 255: للحصول على أنظف إزالة للون، اترك شفافية خلفية الكروما على أعلى قيمة (255)
• 🔤 فعّل خلفية النص: إذا كان الفيديو مشغولاً بالألوان، فعّل خلفية النص الشبه شفافة من إعدادات الكروما لتسهيل القراءة
• 📏 اختبر حجم الخط: ابدأ بحجم 48 وعدّل حسب حجم الشاشة ومسافة القراءة
• ⌨️ تحكّم بسرعة: استخدم F5 لإخفاء/إظهار الكروما بسرعة أثناء البث عند عدم الحاجة للنص

📋 ملخص الاختصارات المهمة أثناء البث

الاختصار	الوظيفة
F5	تشغيل/إيقاف الكروما بسرعة
Ctrl+K	فتح إعدادات الكروما
→ / ←	التنقل بين الشرائح (التالي/السابق)
B	إظهار شاشة سوداء (إخفاء المحتوى)
+ / -	تكبير/تصغير الخط أثناء العرض
Shift+Click	قائمة الترانيم: إضافة فقط • برنامج العبادة: النقر أو F2 للعرض

📹 الاستخدام مع Zoom

تطبيق دكسولوجي يعمل بسلاسة مع Zoom لعرض الترانيم والآيات الكتابية في الاجتماعات والعبادات عبر الإنترنت. لا يوجد تكامل مباشر مع Zoom، لكن التطبيق يتوافق تماماً عبر مشاركة الشاشة.

🖥️ طريقة الاستخدام مع Zoom

1. افتح اجتماع Zoom وابدأ الاجتماع أو انضم إليه
2. اضغط "مشاركة الشاشة" (Share Screen) في Zoom
3. اختر الشاشة أو النافذة:
   • اختر الشاشة التي يعرض عليها دكسولوجي (إن كنت تستخدم شاشات متعددة)
   • أو اختر نافذة العرض الخاصة بتطبيق دكسولوجي
4. ابدأ العرض في دكسولوجي — سيظهر المحتوى للمشاركين في Zoom مباشرة

⌨️ التحكم أثناء الاجتماع

يمكنك التحكم في العرض باستخدام مفاتيح لوحة المفاتيح:

• → / ← — التنقل بين الشرائح (التالي/السابق)
• F3 — الشاشة السوداء (إخفاء المحتوى مؤقتاً)
• ESC — إغلاق العرض

💡 نصائح للاستخدام مع Zoom

• شاشة واحدة: إذا كان لديك شاشة واحدة فقط، شارك الشاشة كاملة أو نافذة العرض
• شاشات متعددة: استخدم زر "⚙️ اختيار الشاشات" لتحديد الشاشة المناسبة، ثم شاركها في Zoom
• وضوح النص: استخدم اختصارات + و - لضبط حجم الخط حسب الحاجة

🎬 مصدر الفيديو

عرض فيديو مباشر من الكاميرا أو مصدر خارجي على شاشات العرض.

🚀 فتح إعدادات الفيديو

• اضغط Ctrl+V لفتح إعدادات الفيديو
• أو اضغط F6 لتبديل الفيديو (تشغيل/إيقاف)
• أو اذهب إلى قائمة إعدادات » الكروما والفيديو » اختيار مصدر الفيديو

📹 الاستخدامات

• عرض فيديو من كاميرا متصلة بالحاسوب
• عرض فيديو من مصدر خارجي (Capture Card)
• التبديل بين الفيديو والنص أثناء العبادة

🔵 دعم الكاميرات الافتراضية (OBS Virtual Camera وغيرها)

يدعم التطبيق الكاميرات الافتراضية التي تنشئها برامج البث مثل OBS Virtual Camera و Snap Camera و XSplit VCam وغيرها. هذا يتيح لك:

• إدخال مخرج OBS كمصدر فيديو في دكسولوجي: جهّز مشهداً في OBS (مثل تبديل بين عدة كاميرات) ثم شغّل Virtual Camera، واختره كمصدر فيديو في دكسولوجي
• استخدام Snap Camera: أضف فلاتر وتأثيرات على الكاميرا ثم أدخلها في دكسولوجي

📋 كيفية استخدام OBS Virtual Camera مع دكسولوجي

1. افتح OBS Studio وجهّز المشهد المطلوب
2. اضغط Start Virtual Camera في أسفل نافذة OBS
3. في دكسولوجي: اضغط Ctrl+V لفتح نافذة مصادر الفيديو
4. اضغط تحديث المصادر — ستظهر الكاميرا الافتراضية مع رمز 🔵
5. اختر OBS Virtual Camera واضغط موافق
6. اضغط F6 لتفعيل عرض الفيديو

🔠 التحكم بحجم الخط أثناء العرض

يمكنك تغيير حجم الخط مباشرة أثناء العرض على الشاشات.

🎯 كيفية الاستخدام

• اضغط + (زائد) لتكبير الخط
• اضغط - (ناقص) لتصغير الخط
• التغيير يظهر فوراً على جميع شاشات العرض
• الحجم يحفظ تلقائياً للاستخدام القادم

🎮 أجهزة التحكم عن بُعد

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

🔗 Logitech R400 وأجهزة العرض المشابهة

• التطبيق يدعم أجهزة التحكم مثل Logitech R400/R800
• أزرار التنقل (التالي/السابق) تعمل تلقائياً
• زر الشاشة السوداء يعمل مع التطبيق
• لا حاجة لإعدادات إضافية — يعمل تلقائياً مع أي جهاز يرسل مفاتيح الأسهم

📦 تحديث التطبيق

نظام تحديث ذكي للحصول على أحدث إصدار من التطبيق.

🔍 التحقق من التحديثات

• اذهب إلى قائمة مساعدة » التحقق من التحديثات
• سيتحقق التطبيق من وجود إصدار جديد
• إذا وُجد تحديث، ستظهر رسالة مع تفاصيل الإصدار الجديد
• اختر "تحديث الآن" لتنزيل وتثبيت التحديث

⚡ التحديث التلقائي

• التطبيق يتحقق تلقائياً من التحديثات عند بدء التشغيل
• إذا وُجد تحديث، ستظهر إشعار بذلك
• يمكنك اختيار تحديث الآن أو لاحقاً

💾 تحديث قواعد البيانات

تحديث قواعد بيانات الترانيم للحصول على أحدث البيانات.

🎯 كيفية التحديث

• اذهب إلى قائمة أدوات » تحديث قواعد البيانات
• سيتحقق التطبيق من وجود تحديثات لقواعد البيانات
• إذا وُجدت تحديثات، سيتم تنزيلها وتطبيقها تلقائياً
• الترانيم الحالية لن تتأثر — التحديث يضيف فقط ولا يحذف

🔑 تفعيل التطبيق

نظام التفعيل والتسجيل للحصول على الميزات الكاملة.

⚠️ مؤشر التفعيل

• إذا لم يكن التطبيق مفعلاً، يظهر رمز ⚠️ في شريط العنوان
• التطبيق يعمل بشكل كامل لكن مع تذكير دوري بالتفعيل

🎯 كيفية التفعيل

• اذهب إلى قائمة مساعدة » التفعيل
• أدخل مفتاح التفعيل
• اضغط "تفعيل" — ستظهر رسالة تأكيد
• بعد التفعيل، يختفي رمز ⚠️ من شريط العنوان

🎮 الاختصارات العامة

الاختصار	الوظيفة
F1	فتح المساعدة
Ctrl+N	برنامج عبادة جديد
Ctrl+O	فتح برنامج عبادة
Ctrl+S	حفظ برنامج العبادة
Ctrl+Shift+S	حفظ برنامج العبادة باسم جديد
Ctrl+D	اختيار الشاشات
Ctrl+P	إظهار/إخفاء عمود المعاينة
Ctrl+A	فتح نافذة التنبيهات
Ctrl+B	إعدادات الخلفية
Ctrl+K	إعدادات الكروما
Ctrl+V	مصدر الفيديو
Ctrl+Shift+T	إظهار/إخفاء شريط مفاتيح F
Alt+F4	إغلاق التطبيق

✏️ التحكم في الترانيم

الاختصار	الوظيفة
Ctrl+M	فتح شاشة إدارة الترانيم
Ctrl+E	تعديل الترنيمة المحددة
Delete	حذف العنصر المحدد

🖥️ التحكم في العرض

الاختصار	الوظيفة
Shift+Click	قائمة الترانيم: إضافة فقط • برنامج العبادة: النقر أو F2 للعرض
F2	بدء عرض العنصر المحدد
Alt+P	عرض العنصر المحدد من برنامج العبادة
→ / ↓ / Enter / Page Down	الشريحة التالية
← / ↑ / Backspace / Page Up	الشريحة السابقة
Home / End	الشريحة الأولى / الأخيرة
0-9	الانتقال لعدد/آية محددة
+ / -	تكبير / تصغير حجم الخط أثناء العرض
Ctrl+End	توسيع الشاهد حتى نهاية الإصحاح
Ctrl+Home	توسيع الشاهد حتى بداية الإصحاح
Enter / Ctrl+Enter (حقل الشاهد)	Enter: إضافة وعرض فوراً • Ctrl+Enter: إضافة فقط
F3	تبديل الشاشة السوداء
F4	إغلاق جميع نوافذ العرض
F5	تبديل الكروما (تشغيل/إيقاف)
F6	تبديل الفيديو (تشغيل/إيقاف)
F7	إيقاف جميع التنبيهات
F12	الخروج الكامل من التطبيق
Escape	إغلاق نافذة العرض أو التنبيه

✨ المميزات

• تمرير سلس: استخدام عجلة الفأرة للتمرير للأعلى والأسفل
• ثبات العناصر: جميع العناصر الأخرى تبقى ثابتة (الشريط، الساعة، الشاهد)
• مؤشر بصري: عرض نسبة التمرير الحالية (0%-100%)
• تلقائي: يعمل فقط عندما يكون النص أطول من الشاشة
• إعادة تعيين تلقائية: عند الانتقال لشريحة جديدة، يعود التمرير للبداية

🎯 كيفية الاستخدام

1. التمرير المباشر على شاشة العرض

• عند عرض نص طويل، ضع الفأرة على شاشة العرض
• استخدم عجلة الفأرة للتمرير للأعلى (لإظهار النص السفلي) أو للأسفل (للرجوع للنص العلوي)
• مؤشر بصري يظهر مؤقتاً (1 ثانية) يعرض النسبة المئوية

2. التمرير من نافذة المعاينة (ميزة مهمة!)

• المشكلة: شاشات العرض في مكان بعيد (قاعة الكنيسة)
• الحل: استخدم عجلة الفأرة على نافذة المعاينة في النافذة الرئيسية
• ضع الفأرة على معاينة الشاشة (الجمهور أو الفريق)
• استخدم عجلة الفأرة للتمرير
• التمرير يُطبّق تلقائياً على الشاشة الفعلية البعيدة
• المعاينة تتحدث فوراً لإظهار التمرير
• مثالي للكنائس: لا حاجة للوصول الفعلي للشاشات البعيدة!

🔄 مقارنة الطريقتين

الميزة	التمرير المباشر	التمرير من المعاينة
الموقع	على الشاشة الفعلية	في النافذة الرئيسية
الوصول	يحتاج وصول فعلي	بدون وصول فعلي
الاستخدام	مباشر	عن بُعد
المعاينة	لا تتحدث	تتحدث فوراً
الأفضل لـ	اختبار محلي	عرض حقيقي في الكنيسة

كيف يعمل النظام؟

• النصوص القصيرة: تباعد أكبر بين الأسطر لراحة القراءة
• النصوص الطويلة: تباعد أقل لاستيعاب المحتوى كاملاً
• تلقائي تماماً: يعمل في الخلفية بدون أي تدخل منك
• محسّن للشاشات الحديثة: مناسب لجميع أنواع الشاشات

🚀 التحسينات الرئيسية

1. تحسين السرعة والاستجابة

• تقليل استهلاك المعالج بنسبة 15-20%
• منع تجميد الواجهة أثناء العمليات
• استجابة أفضل وأسرع للمستخدم
• عمل أكثر سلاسة

2. تحسين كفاءة العرض والمزامنة

• توفير 50% من استهلاك المعالج في الخلفية
• تحسين المزامنة بين الشاشات
• تقليل استهلاك البطارية في الأجهزة المحمولة

3. تقليل حجم البرنامج

• حذف الملفات غير الضرورية
• تحسين البناء والتعبئة
• تقليل حجم الملف بنسبة 25-30%

4. تحسينات الشاشات الحديثة

• دعم أفضل للشاشات عالية الدقة
• تحسين عرض الخطوط والعناصر
• استخدام أمثل للذاكرة

📊 النتائج القابلة للقياس

المقياس	قبل التحسين	بعد التحسين	التحسين
وقت بدء التشغيل	3-5 ثواني	2-3 ثواني	-40%
استهلاك المعالج (خلفية)	5-8%	2-3%	-60%
استهلاك الذاكرة	150-200 MB	120-150 MB	-25%
حجم الملف التنفيذي	~300 MB	~210-240 MB	-25%
حجم assets	47 MB	10 MB	-79%

🎯 نصائح للإعداد والتحضير

🎵 نصائح للترانيم

✏️ تنظيم الترانيم

• استخدم الفئات: صنّف الترانيم حسب المناسبة (عيد، قيامة، تسبحة)
• أضف ملاحظات: اكتب معلومات إضافية (المفتاح الموسيقي، الإيقاع)
• المفضلة: ضع علامة على الترانيم الأكثر استخداماً
• الترقيم: احتفظ بنظام ترقيم ثابت لسهولة الوصول

🎼 التعامل مع القرار

• استخدم (ق): اكتب القرار في نفس حقل الأعداد باستخدام (ق) في بداية السطر
• الموضع مهم: ضع (ق) قبل العدد الأول ليظهر في البداية، أو بعده ليتكرر بعد كل عدد
• اختبر قبل العرض: تأكد من ظهور القرار بشكل صحيح في العرض

🖥️ نصائح للعرض

👁️ الرؤية والوضوح

• حجم الخط: اختبر الخط من آخر الصالة - يجب أن يكون مقروءاً بوضوح
• التباين: استخدم ألوان متباينة (نص داكن على خلفية فاتحة أو العكس)
• البساطة: تجنب الخلفيات المزدحمة التي تشتت الانتباه
• الإضاءة: قلل إضاءة الصالة لتحسين رؤية الشاشة

⚡ الأداء والسرعة

• افتح مسبقاً: اجعل التطبيق مفتوحاً والشاشات جاهزة قبل البدء
• احفظ الاختصارات: استخدم F2 للبدء وF4 للإيقاف
• التنقل السريع: استخدم الأسهم للانتقال بين الأعداد بسلاسة
• الشاشة السوداء: اضغط B لإخفاء المحتوى مؤقتاً

🖥️ مشاكل العرض والشاشات

❌ المشكلة: لا تظهر شاشة العرض

الحلول المحتملة:

1. تحقق من التوصيلات:
   • تأكد من توصيل كابل HDMI/VGA بشكل صحيح
   • جرب كابل آخر
   • تحقق من تشغيل الشاشة/البروجكتور
2. إعدادات النظام:
   • على Windows: اضغط Win+P واختر "تمديد" أو "نسخ"
   • تأكد من اكتشاف النظام للشاشة الثانية
3. في التطبيق:
   • افتح إعدادات » اختيار الشاشات
   • اختر الشاشة الصحيحة للجمهور والفريق
   • اضغط "تطبيق" ثم F2 لبدء العرض

🎵 مشاكل الترانيم

🔍 المشكلة: لا أجد ترنيمة معينة

الحلول:

• استخدم البحث: اضغط Ctrl+F وابحث بالعنوان أو جزء من النص
• تحقق من الفئة: ربما الترنيمة في فئة مختلفة
• البحث بالجزء: جرب البحث بكلمة واحدة فقط من العنوان

❓ المشكلة: القرار لا يظهر بشكل صحيح

الحلول:

• تحقق من إعداد has_chorus: يجب أن يكون محدداً
• راجع نص القرار: تأكد من كتابته في حقل القرار المخصص
• افحص الموضع: تأكد من اختيار موضع القرار الصحيح
• لا تكرر القرار: لا تكتب القرار مع أعداد الترنيمة

⚡ مشاكل الأداء

🐌 المشكلة: التطبيق بطيء

الحلول:

• قاعدة بيانات كبيرة: احذف الترانيم غير المستخدمة
• موارد النظام: أغلق البرامج الأخرى
• الذاكرة: أعد تشغيل التطبيق إذا كان مفتوحاً لفترة طويلة
• القرص الصلب: تأكد من وجود مساحة حرة كافية

🆘 الحصول على المساعدة

📞 إذا استمرت المشكلة

• سجلات الأخطاء: افحص ملف doxology.log في مجلد التطبيق
• معلومات النظام: سجل إصدار التطبيق ونظام التشغيل
• خطوات إعادة الإنتاج: اكتب الخطوات التي تؤدي للمشكلة