Repolode
Submit
LunarBar-app

LunarBar-app/LunarBar

A free, open-source lunar calendar that lives in the macOS menu bar, showing lunar dates, public holidays, and system calendar events.

View on GitHubWebsite
Stars
1,502
Forks
75
Open issues
0
Last commit
5 hours ago

What is it?

LunarBar is a minimal calendar app for macOS that sits in the menu bar. Clicking the menu bar item opens a compact calendar that displays lunar dates alongside the Gregorian calendar, so you can check traditional Chinese calendar dates without opening a separate app.

The app also shows public holidays and integrates with the macOS Calendar and Reminders apps, letting you see your scheduled events and reminders in the same popover. It is distributed as a signed, notarized sandboxed app, and can be installed from a DMG or with Homebrew.

The project is written in Swift and released under the MIT license. Older macOS versions are supported through separate legacy releases.

Key features

  • 01Shows lunar dates alongside the Gregorian calendar in the menu bar popover.
  • 02Displays public holidays.
  • 03Integrates with macOS Calendar and Reminders.
  • 04Sandboxed, signed, and notarized build.
  • 05Installable via DMG or Homebrew Cask.

Use cases

  • Checking lunar dates for festivals and traditional observances at a glance.
  • Viewing public holidays and upcoming events without opening the Calendar app.
  • Keeping a lightweight calendar always available in the Mac menu bar.

Quick start

  1. 1

    Download LunarBar.dmg from the latest release and drag LunarBar.app to Applications

  2. 2

    Or install via Homebrew

    brew install --cask lunarbar

Things to know

  • Requires macOS 26.0 or later per the badge; older versions need legacy releases.

Topics

#calendar#lunar-calendar#macos#menu-bar#swift#productivity#mac#menubar

FAQ

What is LunarBar?
A free, open-source lunar calendar that lives in the macOS menu bar, showing lunar dates, public holidays, and system calendar events. LunarBar is a minimal calendar app for macOS that sits in the menu bar. Clicking the menu bar item opens a compact calendar that displays lunar dates alongside the Gregorian calendar, so you can check traditional Chinese calendar dates without opening a separate app.
Is LunarBar free to use? What license does it have?
LunarBar is open source under the MIT license. Check the license terms before using it in commercial products.
Is LunarBar still maintained?
Actively maintained. The last commit to LunarBar was on Oct 21, 2026.
What can I use LunarBar for?
Checking lunar dates for festivals and traditional observances at a glance. Viewing public holidays and upcoming events without opening the Calendar app. Keeping a lightweight calendar always available in the Mac menu bar.
How do I install LunarBar?
Download LunarBar.dmg from the latest release and drag LunarBar.app to Applications Or install via Homebrew: brew install --cask lunarbar
Where can I get LunarBar?
The source code and installation instructions are on GitHub: https://github.com/LunarBar-app/LunarBar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects