Skip to content

amirnajaffi/shamsi-calendar-plasmoid

Repository files navigation

KDE Plasma Shamsi Calendar

Integrate the Persian Calendar into your KDE Plasma desktop. Also known as Shamsi Calenar or Jalali Calendar.

Download the plugin from the KDE Store.

Features

  • Multi-language support
  • Five adjustable event types
  • Stack navigation
  • Dual configurable texts on the panel
  • Customize colors, fonts, sizes, and events

Shamsi Calendar Plasmoid Screenshot

Changelog

Requirements

Plasma Version Widget Version Link
6 and above 3.x Plasma 6 Store
5.25 > plasma < 6 2.x Plasma 5 Store
5.24 and below 1.x Plasma 5 Store

Check your Plasma version: plasmashell --version

Install or Update

Option 1: Install from KDE Store

Download directly from the KDE Store.

Option 2: Manual Installation

  1. Clone the repository:
git clone https://github.com/amirnajaffi/shamsi-calendar-plasmoid.git
  1. Navigate to the directory:
cd shamsi-calendar-plasmoid
  1. (Optional) Switch to version 1 for Plasma < 5.24, or version 2 for 5.25 > plasma < 6:
git checkout v1 (or v2)
  1. Install the plasmoid:
kpackagetool6 -t Plasma/Applet --install package

To upgrade from a previous version, use --upgrade instead of --install. There is a --delete flag too.
Alternatively use kpackagetool5 for V1 and V2

  1. Log out and log back in.

Alternative Method: Download the latest .plasmoid file from here and install it using the command above.

Contributing

Contributions are welcome! Please check this list. For major changes, open an issue to discuss them first.

License

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

Acknowledgements

FAQ

  • Trouble installing or updating via KDE Store?

Try the manual installation guide above.

  • Errors after installation?

Ensure you meet the minimum Plasma version requirements. If issues persist, please open a new issue.