Help

Your location

The bar under the app title shows your Nearest City (from GPS) or Selected City (if you chose one).

• Tap the city name to search and pick another city.
• Use Use GPS to refresh your current position.

Nearby musallahs and prayer times are based on this location. Allow location permission for the best results.

Now

See the previous and next aadhan with a live countdown (“ago” / “in …”). For each prayer, the app lists nearby musallahs with their iqamah time and distance.

• Pull down to refresh nearby places and times.
• On Friday, Dhuhr is shown as Jumuah and only places with Jumuah are listed.
• Around Sunrise, you may see a short morning adhkar slideshow.
• Open All Nearby Musallahs for the full list.

Musallahs

Browse places near you. Choose a prayer filter (Fajr–Isha) to sort by that prayer’s iqamah.

• Nearby List — sorted by distance, with iqamah for the selected prayer.
• Map — your position and musallah pins.
• Tap a place to open its details.
• Use Add Musallah (sign-in required) to contribute a new place.

Today

View today’s Gregorian and Hijri dates, previous/next prayer with countdown, and a progress bar between them.

• Each prayer card shows aadhan and your preferred iqamah (from Settings).
• If aadhan alerts are enabled, reminders are prepared from these times.

Qibla

Find the direction of the Kaaba from your location. Hold the phone flat and align the arrow upward.

• Shows bearing, device heading, and approximate distance to Makkah.
• On web, you may see bearing and distance without a live compass.

Settings & account

Account

• Sign in with Google to add, edit, or verify musallahs.
• Update your name, email, or mobile when signed in; use Logout when needed.

Prayer calculation

• Choose a calculation method (e.g. Muslim World League, ISNA, Egyptian, Karachi, Umm Al-Qura).
• Choose Asr method: Shafi or Hanafi (for your personal times).

Aadhan alerts

• Turn notifications on or off.
• Pick a sound (Makkah, Madinah, Egypt, or your own upload where supported) and preview it.

Time adjustments

• Aadhan Time Adjustment — shift aadhan by −15 to +15 minutes per prayer.
• My Preferred Iqamah Time — minutes after aadhan (0–60) for your personal schedule on Today.

Note: each musallah can also store its own Asr madhab and iqamah timetable for that place’s displayed times.

Musallah details

Open any musallah to see:

• Photo, address, landmark, entrance hints, and distance.
• Today’s iqamah for Fajr–Isha.
• Jumuah times and languages (up to three), when available.
• Facilities (wudu, women’s area, disabled access), classes, contact, and social link.
• Directions to open maps navigation.

When signed in, you can tap Details Are Correct to confirm information, or Update to edit the place.

Add or update a Musallah

Sign in first, then use Add Musallah from Musallahs, Now, or Contribution.

• Set the pin on the map (tap the map, use My location, or search for a place).
• Enter name, place type (Mosque / Prayer room), access, address, landmark, and entrance hints.
• Configure iqamah as minutes after aadhan or a fixed time; for Asr, choose Shafi or Hanafi.
• Add up to three Jumuah times and languages, or mark No Jumuah.
• Optionally add contact, facilities, classes, remarks, and a cropped photo.

Accurate information is an amanah. Double-check times and location before saving so others can reach congregation on time.

Menu

• My Account — opens Settings.
• Contribution — why contributing is Sadaqah Jariyah, and a shortcut to add a musallah.
• Help — this guide.
• About Us — Gatepass Codex and how to support the initiative.
• Notification / Share — more options coming soon.
• App version is shown at the bottom of the menu.

Tips & contact

• Keep location accurate when travelling so nearby results stay useful.
• Update iqamah times when your local masjid changes them.
• If the app asks you to update, please install the latest version for security and new features.

Need more help? Email gatepass.codex@gmail.com with your question, device type, and a short description of the issue.