IsItIftarYet

A macOS menu bar app that shows a live countdown to Iftar (Maghrib) time for your location in Malaysia, using official JAKIM prayer time data.

Features

• Live countdown — menu bar shows 🌙 Iftar in 2h 34m, ticking down every second
• Last-minute precision — switches to seconds (🌙 Iftar in 47s) when under a minute
• Post-iftar countup — shows ✅ Iftar was 12m ago for up to 2 hours after Maghrib
• Quiet period — displays just 🌙 between 2 hours post-Iftar and the next Fajr
• Auto-reset — refetches fresh prayer times after the next Fajr, ready for the next day
• Full prayer schedule — click the menu bar icon to see all 7 prayer times for today (Imsak, Fajr, Syuruk, Dhuhr, Asr, Maghrib, Isha), with the next upcoming prayer highlighted
• 58 zones — covers all JAKIM zones across Peninsular Malaysia, Sabah, and Sarawak
• Persistent zone selection — your chosen zone is saved across app restarts

Requirements

• macOS 26.2 or later
• Internet connection (fetches from JAKIM eSolat API)

Building

1. Clone the repo
2. Open IsItIftarYet.xcodeproj in Xcode
3. Select your development team under Signing & Capabilities
4. Build and run (⌘R)

The app will appear in the menu bar only — no Dock icon.

Usage

1. Launch the app
2. The menu bar will show the countdown to Iftar for your zone (defaults to Kuala Lumpur)
3. Click the menu bar item to see today's full prayer schedule
4. Go to Zone to change your JAKIM zone

Data Source

Prayer times are fetched from the JAKIM eSolat API (e-solat.gov.my). Times are fetched once per day (on launch and after Fajr). JAKIM may change their API endpoint without notice.

License

MIT