Chinese Calendar for DankMaterialShell

August 20, 2026 · View on GitHub

Screenshot

Display Chinese lunar calendar (农历) with holiday information directly in your status bar.

Features

  • Status Bar Widget: Customizable display of Gregorian and Lunar dates.
  • Full Lunar Calendar: Popup view showing lunar dates, solar terms (节气), and festivals.
  • Holiday Integration: Real-time indication of holidays and make-up workdays (调休) sourced from holiday-cn.
  • Smart Navigation: Scroll to change months, click to jump to specific dates, and quick return to "Today".
  • Detailed Info: View detailed information for any selected date, including days until the next holiday.

Requirements

  • System Package: ccal is required for generating lunar calendar data.
  • System Package: curl is required for fetching holiday definitions.
  • Network connection for holiday data updates.

Configuration

  1. Go to Plugin Settings.
  2. Customize the Date Format string (e.g., ddd MM月dd日 LL).
    • Supported tokens: LL (Lunar Date), yyyy (Year), MM (Month), etc.

Install ccal

Arch Linux / Manjaro

yay -S ccal

Permissions

  • settings_read / settings_write
  • process
  • network

Credits

This project is based on and powered by:

  • ccal: Provides the core lunar calendar calculation engine.
  • holiday-cn: Provides the holiday arrangement data source.

Feedback & Contributions

Suggestions for improvements and feature requests are always welcome. If you have ideas, encounter issues, or want to see new features, feel free to open an issue or submit a pull request.