Skip to content

omid/Persian-Calendar-for-Gnome-Shell

Repository files navigation

Persian Calendar for GNOME Shell

A GNOME Shell extension that displays Persian (Iranian/Jalali), Gregorian, and Hijri (Lunar) calendars in the top bar.

Screenshot

Features

  • Display Persian, Gregorian, and Hijri dates
  • Support for multiple calendar formats
  • Customizable appearance
  • Event and holiday support
  • RTL language support
  • Accessibility features

Installation

Recommended way

For developers

  • Clone the repository
  • Go to the cloned directory
  • run make command in the terminal
  • Restart GNOME Shell. (ALT+F2, r, Enter OR logout/login)
  • You may need to enable the extension via GNOME Extensions application

Troubleshooting

  1. I don't see the ON/OFF button, or it's disabled, but I see a blue message on top of the website, with a message like: “To control GNOME Shell extensions using this site you must install GNOME Shell integration that…”. What should I do?
    • In this case, you must install the gnome-browser-connector package on your system. For example, on Ubuntu, you should run: apt install gnome-browser-connector
  2. I enable the extension, but it doesn't appear and when I refresh the page, it's disabled again! Why?!
    • Run gnome-extensions application and make sure extensions are enabled and the toggle in front of the extension is turned on also.

Date formatting

Format Code Meaning Example Output
%Y Year with century ۱۴۰۲
%y Year without century (zero-padded) ۰۲
%MM Month name آبان
%mm Month name (short) آبا
%M Month number (zero-padded) ۰۸
%m Month number ۸
%D Day of the month (zero-padded) ۰۱
%d Day of the month ۱
%WW Day of the week چهارشنبه
%ww Day of the week (short) چهار
%w Day of the week (very short) چ

Developed with 💚

Links