Calendarium

UUID: calendarium@kami911
Last edited:
1 week ago 2026-10-28, 15:38
Last commit: [d249acac] calendarium@kami911: Add Finnish support (#1938)

A rich calendar desklet with moon phase, sunrise/sunset, zodiac, name days, traditional month names, and optional Wikipedia features.

README

Close

Calendarium

A rich, highly customizable calendar and astronomical information desklet for the Cinnamon Desktop.

Features

  • Date & Time — Customizable strftime format, 12/24-hour, optional seconds
  • Calendar Highlights — Day of year, ISO week number, month progress, New Year countdown
  • Traditional Month Names — Old Hungarian, Old English (Anglo-Saxon), Old German
  • Folk Calendar Sayings — Traditional folk weather/calendar lore for today
  • National Holidays — Public holidays, weekends, upcoming-holiday lookahead, and active/upcoming seasonal periods (e.g. Advent, Lent)
  • Moon Phase — Locally calculated phase, symbol, name, and age in days, plus moonrise/moonset
  • Sunrise & Sunset — Locally calculated from configurable coordinates (default: Budapest), plus offline city search and up to 3 additional cities with local time / UTC offset
  • Equinox & Solstice — Countdown to the next seasonal event
  • Western Zodiac — Sign with Unicode symbol
  • Chinese Zodiac — Year animal and element
  • Name Days — Today plus up to 10 days lookahead, optional two-column layout (Hungarian, German, English, French, Spanish, Italian datasets)
  • Alternate Calendars — Julian, Hebrew, Islamic, and Persian date display
  • Wikipedia (opt-in, internet required) — On-this-day events/births/deaths and article of the day, with rotation, caching, and automatic English fallback
  • Appearance — Configurable icon size, text scale, and background opacity

Available in Hungarian, German, English, French, Spanish, and Italian.

Note to users and developers

This desklet was created with the support of AI technologies.

Note to localizers

Translations use standard Gettext .po files in files/calendarium@kami911/po/. To compile translations:

cd /path/to/cinnamon-spices-desklets
./cinnamon-spices-makepot calendarium@kami911

To add a new UI language:

  1. Run cinnamon-spices-makepot calendarium@kami911
  2. Create po/XX.po based on po/calendarium@kami911.pot

Contributing Name Days

To add name day data for a new language, open a pull request with:

  1. files/calendarium@kami911/data/namedays/XX.json — map of "MM-DD": ["Name1", …] entries
  2. A new option added to the nameday-locale key in settings-schema.json

Note: Do not edit files inside the installed desklet directory directly — those changes will be overwritten the next time the desklet is updated.

Contributing Traditional Month Names

To add traditional month names for a new language, open a pull request with:

  1. A new xx: […] array added to Localization.TRADITIONAL_MONTHS in lib/localization.js
  2. A new option added to the traditional-lang key in settings-schema.json

Note: Do not edit files inside the installed desklet directory directly — those changes will be overwritten the next time the desklet is updated.

License

GPL-3.0

Log In To Comment!

11 Comments

CyberWolf
CyberWolf-1 week ago
Well, I took the liberty to use an AI to correct the moon phases in the desklet. Now based on proper info, at least for northern hemisphere. Works just right now. only other change I had it make was changed calendarium@kami911 to calendarium_2@kami911 so as to delineate difference in I guess version number.
MahtiAnkka
MahtiAnkka-1 week ago
A fantastic desklet! It’s packed with all sorts of great features. Works offline is a big plus. The Wikipedia section is an added bonus. I created a Finnish translation for this. I worked for many days on the nameday and folkday section. It was definitely worth it. We don’t have many similar programs here in Finland. Thank you for making this desklet
CyberWolf
CyberWolf-1 week ago
Please, for moon phases, add more proper delineations. I have one on my Android and where currently on your desklet it is still saying FULL MOON, it should be saying WAXING GIBBOUS as it IS after the FULL MOON. I feel having better breakdown of the moon phases would be a major improvement. Thank you.
Gnomefellow
Gnomefellow-3 weeks ago
This is amazing, and everything I've always wanted on my desktop. If I could suggest anything, it would be font customization so that the information can display in the medieval serif font I've got my desktop set to.
SooltDev
SooltDev-2 months ago
Thanks kami911. An app that fills a real void!
KAMI
KAMI-2 months ago
I really appreciate the kind words. I’m glad to hear the app is filling a real need!
CyberWolf
CyberWolf-2 months ago
Really good desklet. Please add the ability to put a thin border around it though, so I could have it blend in with the rest of my desklets.
KAMI
KAMI-2 months ago
In the latest PR I added this function. Like this: https://linuxmint.hu/sites/default/files/kommentkepek/calendarium_szerkesztheto_keret_01.png The border width, the color and the box radius are customizable.
KAMI
KAMI-2 months ago
Thank you very much for the feedback and the suggestion! I think a thin border would be a great addition. What kind of settings would you find useful for the border? For example, border thickness, color, opacity, or perhaps a rounded-corner option? I’d be happy to hear what would work best for you.
MarcoB0049
MarcoB0049-3 months ago
Hey, Super Arbeit, klasse Desklet, gefällt mir sehr. Vielen Dank! Hey, great work, great desklet, I really like it. Thank you!
KAMI
KAMI-2 months ago
Thank you so much for your kind feedback! I’m really happy to hear that you like the desklet.