Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Prayers

A tiny macOS menu bar app that shows Muslim prayer times for wherever you are. It sits in your menu bar and counts down to the next prayer — no accounts, no internet needed. All times are calculated right on your Mac.

Prayers in the menu bar

What it does

  • Lives in your menu bar and shows the next prayer and a countdown (e.g. Dhuhr 4h 11m).
  • Click it to see the full day: Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha.
  • Shows the Hijri (Islamic) date and your city.
  • Finds your location automatically, or lets you pick.
  • Works offline — prayer times are computed locally, nothing is sent anywhere.

Prayer times panel   Settings window

You can also change the calculation method, the Asr madhab, the high-latitude rule, whether to show the prayer name in the menu bar, and whether to launch at login.

Install (the easy way)

You'll build the app once with Xcode. It sounds scary, but it's just a few clicks.

  1. Get Xcode. Open the App Store on your Mac, search for Xcode, and install it. (It's free and made by Apple.)
  2. Download this project. On this page, click the green Code button → Download ZIP. Then double-click the ZIP to unzip it.
  3. Open the project. Inside the unzipped folder, double-click Prayers.xcodeproj. Xcode will open.
  4. Press Play. At the top-left of Xcode, click the ▶ (Run) button, or press ⌘ + R on your keyboard.
  5. That's it! The prayer time icon appears in your menu bar at the top of the screen.

The first time it opens, macOS may ask for permission to use your location — click Allow so it can find your city.

Tip: To keep the app, drag Prayers.app from Xcode's build products into your Applications folder. Turn on Launch at login in Settings so it starts automatically every time.

Build from the command line (optional)

If you prefer the Terminal:

git clone https://github.com/o-rashad/prayers.git
cd prayers
xcodebuild -project Prayers.xcodeproj -scheme Prayers -configuration Release build

Requirements

  • macOS 13 (Ventura) or newer
  • Xcode 14 or newer (only needed to build it)

Privacy

Prayers never sends your location or any data anywhere. Everything — including your location and the prayer time math — happens on your Mac.

License

MIT

About

Install and forget - A tiny macOS menu bar app that shows Muslim prayer times, computed locally on your Mac.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages