mahdigudarzi / shamsi-calendar-plasmoid

Shamsi calendar plasmoid

KDE Plasma Shamsi Calendar

Integrate the Persian (Shamsi - Jalali) calendar into your KDE Plasma desktop with the Shamsi Calendar Plasmoid. Developed with precision and user-centric design, this plasmoid has evolved from a personal project to a feature-rich tool tailored to your needs.

You can find and download the Shamsi Calendar plugin on the KDE Store here.

Features

• Multi-language support for a personalized experience.
• 5 adjustable events types.
• Navigate using stack navigation.
• Display dual parallel configurable texts (Primary and Secondary) on the panel.
• Personalize colors, fonts, sizes, and events to suit your style.
• And more!

KDE Store - CHANGELOG

Requirement

Plasma Version	Widget Version
5.25 and above	2.x
5.24 and below	1.x

Check: plasmashell --version

Install/Update 📦

You've got two options to get this plasmoid up and running: you can either grab it from the KDE Store or follow these simple steps below.

1. Clone/Download repo:

Let's get the plasmoid's source code. Open your terminal again and enter:

git clone https://github.com/amirnajaffi/shamsi-calendar-plasmoid.git

2. Open directory:

Navigate into the newly created directory:

cd shamsi-calendar-plasmoid

*Optional: If you're feeling nostalgic and want to install version 1 (or! maybe your out of Requirement of v2), type:

git checkout v1

3. Install:

It's time to bring the magic to life! Use this command in your terminal:

kpackagetool5 -t Plasma/Applet --install package

If you have a previous version installed, use --upgrade in above command instead.

Or alternatively, type in the terminal to remove the previous versions: (And you can re-install the new version after that).

kpackagetool5 -t Plasma/Applet --remove org.kde.plasma.shamsi-calendar

4. Log Out/In

Log out of your system and then log back in. Now everything is done! 😃

As an alternative way simply you can grab the latest .plasmoid file from this page and install it with above commands.

Contributing

Thank you for considering contributing to the KDE Plasma Shamsi Calendar! Any contributions you make are greatly appreciated. You can also check this list.

For major changes, please open an issue first to discuss what you would like to change.

License

Distributed under the GPL v3 License. See LICENSE for more information.

Acknowledgements

• i18next
• jalaali-js
• Persian Date
• Persian Calendar for Gnome-Shell
• tarikh-npm
• Vazirmatn Font

FAQ

• Having Trouble Installing or Updating via KDE Store? If you're facing issues with installation or updates from the KDE Store, don't worry! We've got you covered with a simple manual installation guide.

• Encountering Errors After Installation? Sometimes, errors might pop up after installation, and that's okay. Often, these errors are caused by having an older version of Plasma. Make sure you have at least the minimum required Plasma version installed. If you're still facing issues, feel free to open a new issue – we're here to help!