نبذة عامة

بلال هو برنامج حر ومفتوح المصدر يحسب أوقات الصلاة وفق المدينة المختارة ويصدر الأذان بصوت كوكبة من أجمل المؤذنين في العالم الإسلامي كما تشير إليه مقتطفات الشاشة أسفله. بلال لا يقرأ الموقع الحالي للمستخدم و لايجمع أي معلومات شخصية. وبالتالي فهو لا يشارك أي معلومات مع أي جهة. عكس ما تقوم به بعض برامج الأذان التي كُشف أنّها تتجسس على المسلمين. بلال يحمي خصوصية المستخدم كليا.

بلال يستعمل نسخة مطورة في لغة جافا من مكتبة أوقات الصلاة التابعة لمشروع "عيون العرب". تم تطويره بادئ الأمر في إطار آكاديمي لتجربة مزايا منصة الأندرويد مثل التنبيهات والإشعارات ودعم الساعات الذكية. مصدره متوفر تحت رخصة غنو العمومية الإصدار الثالث كي يتمكن كل من يرغب في تطويره وزيادة ميزات جديدة عليه.

Overview

Bilal is a free and open source software that displays Muslim Prayer times and plays Athan on Android phones and tablets. It does not read the user location nor does it collect any personal data. It does not share anything with any party. Unlike other Athan apps which were found to spy on Muslims. Bilal protects user privacy.

Bilal uses a Java version of the PrayerTime package that is part of Islamic Tools Library from the Arab Eyes project. This library provides also the calculation methods shown in the screenshots below. It was initially developed for academic purposes to demonstrate some Android features (Alarm, Notification, Wear support etc.). It was open sourced under GPLv3 in the hope that volunteers can contribute changes to improve it. See the TODO file for that.

Currently it contains the coordinates of 23784 cities in 250 countries around the world, extracted from the geoname.org project. Adding a new city or adjusting the coordinates of an existing one can de done in the sqlite locations.db3 database in app/src/main/asset/databases.

It is possible to add/replace a Muezzin by adding/modifying its mp3 files in app/src/main/res/raw and the corresponding XML resources.

Bilal is deployed in Google Play Store as "Athan Bilal":

هناك نسخة متوفرة من بلال في متجر جوجل للتطبيقات تحت اسم "أذان بلال":

Screenshots مقتطفات الشاشة

Testing

• Testing with two emulators (phone + watch) is not possible any more due to changes in recent Android SDKs that prevent pairing them together. Instead, you can use a watch emulator with a real phone where you need to install the app 'Wear OS by Google'.

• To test with two emulators (phone + watch) using SDK 26 and x86 emulator images follow these steps:

• Use a phone emulator with Google API support.

$ /opt/android-sdk-linux/tools/emulator -avd phone -netspeed full -netdelay none -no-boot-anim -gpu on -qemu -m 512 -enable-kvm

1. Use a smart watch emulator to see Prayer Time wear notification.

$ /opt/android-sdk-linux/tools/emulator -avd watch -netspeed full -netdelay none -no-boot-anim -gpu on -qemu -m 512 -enable-kvm

1. Google and download the old 'Android Wear' app and install it on the phone emulator:

$ /opt/android-sdk-linux/platform-tools/adb -s emulator-5556 install ~/Downloads/com.google.android.wearable.app-2.apk

1. Pair the emulators as follows: a. find out the port used by the phone emulator (from its window title) or using:

   $ /opt/android-sdk-linux/platform-tools/adb devices

b. log into the phone emulator using telnet:

$ telnet localhost 5556

c. in the telnet session add a tcp port redirection like this:

redir add tcp:5601:5601

d. run the wearable app on the phone, accept the licence and choose 'Pair with a new device'. Upon success the message 'connected' will appear in the action bar.

1. Start Bilal then play with the time settings to trigger a notification.