إضافة PrayerTime (NVDA) — إدارة الأذان/الأذكار/القرآن

مرحبًا! هذه إضافة NVDA خفيفة للمكفوفين لإدارة الأذان والتنبيهات وتشغيل الأذكار والقرآن بسهولة، مع منع تداخل الأصوات ودعم التشغيل اليدوي (تكرار/التالي).

> تعمل الإضافة محليًا، وتستخدم VLC للتشغيل الصوتي، وداعمة للعربية بشكل كامل.

ماذا تقدّم؟

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

المتطلبات

• Windows 10 أو أحدث، NVDA 2023.2 أو أحدث.
• تثبيت VLC على ويندوز (عادة في: C:\Program Files\VideoLAN\VLC).
• ملفات صوت بصيَغ شائعة (.mp3, .wav, ...).

التثبيت

1) افتح NVDA → الأدوات → مدير الإضافات → تثبيت من ملف…

2) اختر ملف الإضافة ذو الامتداد .nvda-addon ثم وافق على إعادة التشغيل.

البدء السريع

1) من إعدادات الإضافة، حدّد الدولة/المدينة.

2) فعِّل خيار تشغيل الأذان إن رغبت، واضبط وضع الصوت (افتراضي/مخصّص/عشوائي/موحّد).

3) جرّب التشغيل من اختبار الأذان للتأكد من وصول الصوت.

4) للتشغيل اليدوي: افتح أي ملف قرآن/أذكار وشغِّله من أوامر الإضافة.

التشغيل اليدوي والتحكم

• تكرار الملف الحالي: يعيد تشغيل نفس الملف تلقائيًا بعد انتهائه.
• التالي تلقائيًا: يشغِّل الملف التالي في نفس المجلد بترتيب الاسم.
• قناة مستقلة للتشغيل اليدوي: التكرار/التالي يعملان فقط في الوضع اليدوي، ولا يؤثران على تنبيهات الأذان.

مستوى الصوت

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

التنبيهات

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

> لو لم يُعثر على ملف صوت مناسب لبعض التنبيهات، قد يصدر صوت بيب بسيط بدلًا منه.

نافذة اختيار التنسيقات

يمكنك فصل التنسيق بين:

• ملف بيانات الصلاة (مثل .txt أو .json…)،
• تفاصيل المدينة (تنسيق مختلف إن رغبت).

هذه النافذة غير حاجبة لواجهة NVDA، ويتم حفظ الاختيار مباشرة في الإعدادات.

الاختصارات (لوحة المفاتيح)

كل الأوامر تظهر تحت تصنيف PrayerTime في مدير اختصارات NVDA:

1) افتح NVDA → التفضيلات → إدخال الأوامر (Input Gestures).

2) ابحث عن PrayerTime وحدِّد الاختصارات المناسبة لكل أمر مثل:

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

> الأسماء قد تختلف قليلًا حسب إصدارك؛ إن لم تجد أمرًا معينًا، جرّب تحديث الإضافة أو راجع صفحة “حول الإضافة”.

استكشاف الأخطاء الشائعة

• لا يوجد صوت:
• تأكد من تثبيت VLC وأن الامتدادات الصوتية المدعومة مستخدمة.
• اختبر ملفًا آخر (MP3/WAV).
• الأذان لا يعمل:
• افحص تفعيل “تشغيل الأذان” ووضع الصوت في الإعدادات.
• تأكد من وجود ملفات الأذان الافتراضية/المخصّصة في مجلداتها.
• تداخل أصوات:
• تمت إضافة حراسات تمنع التداخل. إن حدث، أوقف جميع الأصوات ثم أعد المحاولة.
• صفحة المساعدة لا تُفتح:
• تأكد أن الحزمة تحتوي: doc/style.css وdoc/ar/readme.html (ولغات أخرى حسب الحاجة).
• في manifest.ini: يجب أن يكون docFileName = readme.html.

الخصوصية

• تعمل الإضافة محليًا، ولا ترسل بياناتك لأي خادم.
• سجلات الأخطاء تحفظ محليًا داخل مجلد الإضافة.

الشكر

جزيل الشكر لكل من ساهم بالدعم والتجربة.

دعواتكم، وبالتوفيق للجميع.