Amirhossein HosseinpourAmirhpCom
Resume Book a consultationBook
Active macOS app · Open source

jDate

The Jalali date in your Mac's menu bar.

macOS shows the Gregorian date only. jDate puts the Persian date in the menu bar and opens a popover with the month, the Gregorian and Hijri dates, Iranian holidays, your own calendars and birthdays, weather and world clocks. Version 8 adds desktop widgets, 8.1 adds occasion themes for Nowruz, Ramadan, Christmas and more and animated or video headers, and 8.2 makes the popover Liquid Glass with a Terminal-style blur and adds a year calendar of birthdays.

Download for Mac Source on GitHub

Free, GPL v3, no accounts. The app is not notarized, so the first launch needs right-click, Open. Figures from the GitHub API, 3 November 2026.

On GitHub2024 to today

What it does

Click the date in the menu bar. Everything else is one click from there.

Three calendars

Jalali, Gregorian and Hijri dates side by side. Click one to copy it, or press ⌘C, ⌘X or ⌘A. The Hijri date has a day offset and a choice of variants.

Iranian holidays

Solar and lunar public holidays, Yalda, Chaharshanbe Suri and other occasions are built in, so the month shows them without a network connection.

Your calendars and birthdays

Google, iCloud and other calendars through macOS Calendar, public ICS feeds, and birthday reminders from Contacts or your own list in any of the three calendars, with a year calendar and a timeline of the next twelve months.

Weather and world clocks

Current weather and a 5 to 7 day forecast from Open-Meteo, MET Norway, wttr.in, OpenWeatherMap or WeatherAPI, plus clocks with the time difference.

Your layout

Show, hide and reorder sections, size widgets to a full, half or third row, any installed font, a wide two-column popover, and your own colors for holidays and weekends, with the weekend days you choose.

Headers and glass

A seasonal, weather or animated header, your own photo or looping video, and occasion themes that switch on by themselves. You pick which lines the header shows, their size and color. The popover is Liquid Glass with your color, opacity and blur, and one preset copies Terminal's Pro look.

Tools

A date converter, a date difference calculator, a menu bar icon designer with your own date format, a global shortcut (⌃⌥J) and launch at login.

Screenshots

Version 8.0: the wide popover, the classic one with widgets, and the layout editor.

The wide jDate popover: today's date in three calendars at the top, the selected day's events on the left and the Jalali month on the right, with the Gregorian and Hijri day under each date.
Wide popover
  • The classic jDate popover with an autumn header, three date cards, weather, two world clocks, a Nowruz countdown and the month calendar.
    Classic popover
  • The Customize page: popover sections and widgets with show, hide, reorder and size controls next to a live preview.
    Customize the popover

Themes for the day

Version 8.1: thirteen occasion themes turn on during their days and go back to your own style after. Each one can be turned off.

Six jDate headers for the same day in different occasion themes: Nowruz blossoms, Ramadan crescent and lanterns, Christmas snow, 4th of July fireworks, Chaharshanbe Suri sparks and Yalda pomegranates.
Occasion headers: Nowruz, Ramadan, Christmas, 4th of July, Chaharshanbe Suri, Yalda
  • The jDate popover with a see-through smoke background and an animated lava lamp header showing a picked day with a Back to today button.
    Glass background, animated header
  • The Theme settings page with header types as tiles and a grid of occasion themes with their dates.
    Theme settings

New in 8.2

The popover is real Liquid Glass and blurs the desktop behind it the way Terminal does. Birthdays get a year calendar and a timeline, and each line of the header can be hidden, resized or recolored.

  • The jDate popover in Liquid Glass with the Terminal preset: a dark tint over a blurred forest desktop, the autumn header and the Aban month calendar.
    Liquid Glass, Terminal preset
  • The Birthdays page in Year view: Jalali month cards with birthdays marked as pink circles and a count per month.
    Birthdays, year calendar

Desktop widgets

Today, Month, World Clock, Upcoming, Weather and Countdown, for the desktop or Notification Center. Since 8.1 they can share one glass background that you set in the app.

  • The medium Today widget with the Jalali date large and the Gregorian and Hijri dates beside it.
  • The large Weather widget with the current temperature and a six day forecast.
  • The large Month widget with the Jalali month grid and weekends and holidays in color.

How it works

A SwiftUI app in an NSPopover, with no third-party code.

Dates come from Foundation's Persian and Islamic calendars. The holiday table is a Swift list of solar dates and Hijri dates converted with your offset, so Ashura or Eid move correctly from year to year. Calendar events come from EventKit and birthdays from the Contacts framework, and both are asked for only when you turn the feature on.

The widgets are a WidgetKit extension. The app writes the day's events and the last weather reading into a shared App Group file, and the widgets read it, so they stay up to date without their own network calls. Weather providers fall back to Open-Meteo when the one you picked fails.

On macOS 26 the popover keeps the system Liquid Glass view and puts a backdrop blur layer under it, so the desktop behind is blurred with a radius, like Terminal's Blur slider, and only inside the popover's shape.

// the menu bar date, in Persian digits
let cal = Calendar(identifier: .persian)
let f = DateFormatter()
f.calendar = cal
f.locale = Locale(identifier: "fa_IR")
f.dateFormat = "d MMMM"
f.string(from: .now) // ۱۲ آبان
The core of it, before the popover.

Getting started

macOS 15 Sequoia or later, Apple Silicon or Intel.

  1. Install

    Download jDate.dmg from the latest release and drag Jalali Date to Applications.

  2. First launch

    The app is not notarized, so right-click it, choose Open, then Open again. If macOS still blocks it, click Open Anyway in System Settings, Privacy & Security.

  3. Pick what you want

    Right-click the date in the menu bar for Settings. Turn on calendars, birthdays or weather there; each asks for its permission the first time.

  4. Add widgets

    Right-click the desktop, choose Edit Widgets and search for jDate.

Releases

Every GitHub release with the first line of its notes and its download count, refreshed from the GitHub API every day. The full history is in the changelog.

VersionReleasedWhat changedDownloads
8.2.03 Nov 2026The Jalali, Gregorian and Hijri date tiles follow the day you click in the calendar, and clicking one (or ⌘C, ⌘X, ⌘A) copies that day's date0
8.1.03 Nov 2026Click a day in the calendar and the header shows that day; click the header to jump back to today.2
8.0.02 Nov 2026Desktop & Notification Center widgets: Today, Month, World Clock, Upcoming, Weather and Countdown: each configurable (calendar, digits, style, cities…)2
6.0.023 Mar 2025Date Converter View: Convert dates across Jalali (Persian), Gregorian, and Islamic (Hijri) calendars with a live, side-by-side view.22
3.0.05 Nov 2024fixed icon not updated3
2.0.03 Nov 2024Enhanced Menubar Display: Updated the menubar display to improve clarity and ease of use.3
1.0.03 Nov 2024Initial release on 1403-08-13 | 2024-11-03.4

// open-source/

More open source

The other projects with a page of their own. The rest, 62 in all, are in the explorer, each with its status and where the numbers come from.

Every public project The release record
branch main 33 active projects ↑ 140 releases open-source/jdate.md Sari --:-- UTC+3:30 its@amirhp.com