mohamed-sallam / al-miqata

Al-Miqata is digital Islamic wall clock with prayer times.

Click for English

الميقاتة ⏰🕌

الميقاتة هي ساعة حائط إسلامية رقمية مصممة لمساعدة المسلم في معرفة أوقات الصلاة. بفضل مجموعة متنوعة من الميزات، تهدف الميقاتة إلى التيسير على المسلمين مع الحفاظ على التكلفة المعقولة.

ألا إنني للدين خير أداةِ *** إذا غاب عنكم وقتُ كل صلاةِ
ولم تُرَ شمسٌ بالنهار ولم تُنَر *** كواكبُ ليلٍ حالِكِ الظُلمات
بيُمن إمام المرسلين محمّدٍ *** تجلّت عن الأوقاتِ كلُّ صلاةِ
— منقول بتصرف طفيف عن عباس بن فرناس

مميزات ✨

✅ رخيص 💰
✅ عرض أوقات الصلاة الخمس مع وقت الشروق. 🌅
✅ عرض التاريخ الهجري والميلادي. 🗓️
✅ عرض الوقت بكل من التنسيقين الـ 24 ساعة والـ 12 ساعة. ⏰
✅ عرض يوم الأسبوع الحالي. 📅
✅ الحفاظ على إعدادات الوقت في حالة انقطاع الطاقة. 💡
🚧 يحسب الوقت المتبقي على إقامة الصلاة التالية. ⏳
❌ يمكّن من معايرة الإعدادات (التاريخ، الوقت، الموقع، وما إلى ذلك) عبر تطبيق للأجهزة المحمول باستخدام الواي فاي. 📱🌐

للتواصل

تواصل مع المتطوعين عبر ديسكورد.

Al-Miqata ⏰🕌

Al-Miqata is a digital Islamic wall clock designed to assist Muslims in managing their daily prayers effectively. With its array of features, Al-Miqata aims to provide convenience and utility to its users while maintaining affordability.

Behold, I am the finest aid to faith's decree,
When each prayer's appointed hour you fail to see.
When neither sun illuminates the day's course,
Nor stars in the night sky offer guiding force.
By the grace of the Messenger, Muhammad, so true,
Each prayer's time revealed, clear and anew.
— ChatGPT's translation of a slightly altered Arabic version, originally by Abbas ibn Firnas

Features ✨

• Cost-effective 💰
  • Use more cheaper MCU
• Displays five daily prayer times along with the sunrise time. 🌅
• Presents the date in both Hijri and Gregorian calendars. 🗓️
• Displays time in both 24-hour and 12-hour formats. ⏰
• Indicates the current day of the week. 📅
• Implements a method to preserve time settings in case of power loss. 💡
• 🚧 Provides the remaining time until the Iqama for the upcoming prayer. ⏳
• Enables calibration of settings (date, time, location, ...etc.) through a mobile application using WIFI connectivity. 📱🌐

Contact us

Contact contributers via Discord.

Build and Run 🚀

1. Install PlatformIO extension for VSCode.

Tip

If you are using an Ubuntu-based distribution, it might not be able to identify the Python path. Read this for more information.

2. Open PlatformIO tab from VSCode Activity Bar.
3. Wait until the project is detected by PlatformIO.
4. Click "Build" button under "ATmega328P > General".
5. It should give you success message such as:

   ================ [SUCCESS] Took 0.88 seconds ================
   

   and create .pio/build/ATmega328P/firmware.hex file.
6. Burn .pio/build/ATmega328P/firmware.hex file into your MCU or if you're using Proteus 8.9 or later, open al-miqata_schematic.pdsprj in Proteus and then double click on the ATmega328P MCU on the schematic and in "Program File:" field browse to .pio/build/ATmega328P/firmware.hex.

al-miqata's Issues

Compilation Error In Visual Studio Code

Asalam-U-Aliakum Brother,
I want to build this project for my mosque but i couldn't compile the project in Visual Studio Code Please help if i am missing something while compiling the code in Platform IO, If possible can you come up with detailed instructions on how to compile the project in Visual studio Code, Your response would be much appreciated.

Regards,
Bilal