Skip to content

JulioRahman/Tiba

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tiba

Swift 6.0 macOS 13+ License MIT

Tiba is a native macOS menu bar app for prayer times.

The app keeps the next prayer immediately visible in the menu bar, with a focus on glanceable visual status instead of opening a full schedule app. The name comes from Bahasa Indonesia: "tiba" means "to arrive" or "it's time".

Powered by Aladhan API.

Status

Tiba is an early prototype. The current build covers the core loop:

  • macOS MenuBarExtra app
  • countdown to the next prayer
  • prayer-time lookup
  • daily response cache
  • CoreLocation auto-detection
  • manual latitude/longitude override
  • several menu bar display styles

This project uses AI-assisted development, with product direction and final decisions kept human-owned.

Menu Bar Styles

The menu bar label can be switched between:

  • text only
  • countdown in minutes or hours
  • next prayer time
  • progress arc
  • progress arc with countdown
  • progress arc with prayer initial
  • five-bar prayer indicator
  • five-bar indicator with countdown

The default is Arc + Countdown.

Data Source

Prayer times are fetched from the API linked above.

Tiba requests timings by date and coordinates, then stores the result in the local cache. For normal use, it should only need one API request per day for the current location and calculation method.

Choosing a Calculation Method

Choose the calculation method that best matches your local mosque, city, or regional Islamic authority. If you are not sure, start with Automatic and compare the result with the schedule you already follow.

Common starting points:

  • Indonesia: Kemenag RI
  • North America: ISNA
  • Most international/default use cases: Muslim World League
  • Saudi Arabia: Umm Al-Qura
  • Singapore: Singapore
  • Malaysia: JAKIM
  • Turkey: Diyanet
  • Gulf countries, Qatar, or Kuwait: use the matching named method

Privacy

Tiba uses CoreLocation only to calculate local prayer times.

Location data is used on-device to request prayer times. Cached prayer schedules are stored locally in the user's cache directory. Manual coordinates can be used instead of location access.

Requirements

  • macOS 13 Ventura or later
  • Apple Silicon or Intel Mac
  • Xcode with SwiftUI, AppKit, and CoreLocation support

The project is intentionally macOS-only and native. There is no iOS, Catalyst, or multiplatform target. Release builds are Universal Binaries for both arm64 and x86_64.

Development

Open the project in Xcode:

open Tiba.xcodeproj

Or build from the command line:

xcodebuild -scheme Tiba -project Tiba.xcodeproj -configuration Release -destination 'generic/platform=macOS' build

Project Direction

The immediate goal is to make the menu bar item excellent:

  • more refined arc and bar variants
  • better active-prayer visual language
  • smarter light/dark appearance
  • notification support
  • monthly prayer schedule
  • configurable calculation settings
  • packaging and release flow

Monetization is not a priority yet. The project currently leans open source, with premium customization or donations as possible future options.

License

Tiba is released under the MIT License. See LICENSE for details.

About

Native macOS menu bar app for glanceable prayer-time countdowns, built with SwiftUI, AppKit, CoreLocation, and Aladhan.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages