https://github.com/mohamed-sallam/al-miqata
Al-Miqata is digital Islamic wall clock with prayer times.
https://github.com/mohamed-sallam/al-miqata
embedded-c embedded-systems muslim-prayer-times prayer-times
Last synced: 4 months ago
JSON representation
Al-Miqata is digital Islamic wall clock with prayer times.
- Host: GitHub
- URL: https://github.com/mohamed-sallam/al-miqata
- Owner: mohamed-sallam
- License: gpl-3.0
- Created: 2023-04-16T09:12:53.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-18T12:04:39.000Z (over 1 year ago)
- Last Synced: 2025-04-13T11:50:50.966Z (7 months ago)
- Topics: embedded-c, embedded-systems, muslim-prayer-times, prayer-times
- Language: C
- Homepage:
- Size: 104 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
***[Click for English](#al-miqata-)***
# الميقاتة ⏰🕌
الميقاتة هي ساعة حائط إسلامية رقمية مصممة لمساعدة المسلم في معرفة أوقات الصلاة. بفضل مجموعة متنوعة من الميزات، تهدف الميقاتة إلى التيسير على المسلمين مع الحفاظ على التكلفة المعقولة.
> ألا إنني للدين خير أداةِ *** إذا غاب عنكم وقتُ كل صلاةِ
> ولم تُرَ شمسٌ بالنهار ولم تُنَر *** كواكبُ ليلٍ حالِكِ الظُلمات
> بيُمن إمام المرسلين محمّدٍ *** تجلّت عن الأوقاتِ كلُّ صلاةِ
> — منقول بتصرف طفيف عن [عباس بن فرناس](https://www.aldiwan.net/poem68990.html)
## مميزات ✨
✅ رخيص 💰
✅ عرض أوقات الصلاة الخمس مع وقت الشروق. 🌅
✅ عرض التاريخ الهجري والميلادي. 🗓️
✅ عرض الوقت بكل من التنسيقين الـ 24 ساعة والـ 12 ساعة. ⏰
✅ عرض يوم الأسبوع الحالي. 📅
✅ الحفاظ على إعدادات الوقت في حالة انقطاع الطاقة. 💡
🚧 يحسب الوقت المتبقي على إقامة الصلاة التالية. ⏳
❌ يمكّن من معايرة الإعدادات (التاريخ، الوقت، الموقع، وما إلى ذلك) عبر تطبيق للأجهزة المحمول باستخدام الواي فاي. 📱🌐
## للتواصل
تواصل مع المتطوعين عبر [ديسكورد](https://discord.gg/bKBzGt6g).
# 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](https://www.aldiwan.net/poem68990.html)
## Features ✨
- [x] Cost-effective 💰
- [ ] Use more cheaper MCU
- [x] Displays five daily prayer times along with the sunrise time. 🌅
- [x] Presents the date in both Hijri and Gregorian calendars. 🗓️
- [x] Displays time in both 24-hour and 12-hour formats. ⏰
- [x] Indicates the current day of the week. 📅
- [x] 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](https://discord.gg/bKBzGt6g).
# Build and Run 🚀
1. Install [PlatformIO extension for VSCode](https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide).
> [!TIP]
> If you are using an Ubuntu-based distribution, it might not be able to identify the Python path. Read [this](https://community.platformio.org/t/ubuntu-vscode-pio-extension-install-platformio-can-not-find-working-python-3-6-interpreter/27853/9) 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`.