Moonlight Clock

by torchipeppo

Score 6

Issues Website Download

UUID: moonlight-clock@torchipeppo

Last edited:

3 days ago 2025-04-11, 11:50

Last commit: [8f252d8c] Add/Update Hungarian translations (#1449)

An aesthetic and customizable desklet that can function as clock, weather display, and/or tracker of important dates. Based on Persona 3.

README

Moonlight Clock for Cinnamon

A multipurpose display for current date, time, weather, and/or custom important events.

Features

Two separate lines to display the current date and/or time, fully customizable via strftime
Weather information via WeatherAPI, including current temperature and daily chance of rain (requires you to make an account and get an API key)
Display one or more countdowns to any important dates of your choosing to keep yourself organized
Moon phase display, including a countdown to the next full moon (with optional extra precision, see "Installation")
Last but not least, tweak the appearance to your liking: color, size, font, ...

Screenshots

Default look after enabling WeatherAPI. The default font depends on your system configuration.

A few example customizations that can be made with the desklet's settings.

Configuration that replicates the inspiration material as closely as possible.

Click here to get any of the configurations shown above. All featured fonts are free, and either commonly found by default on Linux Mint machines or available on Google Fonts.

Installation

Download or clone this repo, then put the moonlight-clock@torchipeppo directory (contained in the files directory) into ~/.local/share/cinnamon/desklets/

Optional: run the Python script from my personal repo to generate more precise data for the moon phases

Design goals

Combine the style of the UI from the video game "Persona 3" and Linux/Cinnamon conventions into an effectively useful desktop widget
Provide value to as many users as possible
Keep the option to stay close to the source material, wherever this doesn't conflict with the above points

Bug reports, feature requests, and contributions

Feel free to open issues or pull requests on the Cinnamon Spices repo or my personal one!

Compatibility

Developed, tested and extensively used by the author on Cinnamon 5.0.7 and Cinnamon 6.0.

Likely to work in near-future versions. Unlikely to work in too many older versions due to a simplification made for ease of maintenance.

Log In To Comment!

4 Comments

Nekkowe!-1 month ago

(In case you're curious, here's my settings for now, though I'm still fiddling with the fonts and colours and such: https://i.ibb.co/MxsPfPNY/image.png)

Francesco Petri-3 weeks ago

Nice! (^_^)-b

Nekkowe!-1 month ago

Oh, this is wonderful! I'm having a lot of fun messing around with the settings, being able to change each line with the strftime syntax is awesome, and I'm really happy that the colours are customizable. Even the transparency! Hands down my favourite desklet. I've customized mine to be as "extra" as I could manage. The one thing I'm having some trouble with is styling the bottom row - it'd be nice if there were more exposed settings for adjusting the font, colour and line spacing of the extra "countdowns in secondary text" separately. I'd also love the ability to add a prefix and suffix ("in [x] days", "[x] days left", etc.) around the day numbers. (On that note, between the Cinnamon Spices repo and your personal one, which do you prefer for pull requests?) (And as an aside, which fonts did you use for the middle row on the center and bottom left examples, they look gorgeous!) Thank you very much for your work on this!

Francesco Petri-3 weeks ago

Hi, I'm glad you like this! I hope you'll still read this response even though I wasn't able to answer right away. So, as for styling the secondary text, I had envisioned it as an "extension" of the bottom part, so that's why I kept things simple and had it inherit the style. My concern with adding specific styling options for the secondary text is overcrowding the settings menu, but I guess it's acceptable if the settings are hidden by default under a "copy style from main bottom row" toggle and/or in a dedicated page. Adding pre/suffixes around the countdown is an interesting idea I hadn't thought about. Maybe it's best implemented with another custom format string? Overall, if I'm doing this, it's doable, but I can't give an ETA right now. Speaking of pull requests, I'd say that if you're contributing to something that is on both the Spices repo and my personal one, it's generally best to open a PR on Spices, so the community gets the update as soon as it's accepted by the maintainers. (As the original author, anything other than a trivial patch or a translation needs to be approved by me anyway.) I do port updates from one repo on to the other, but on an inconsistent schedule. Instead, if you're contributing to the couple "extra" things that are only on my personal repo, of course open a PR there. About the fonts: the red example is a semi-chaotic mixture of fonts I already had previously downloaded for a different purpose, they are Pirata One, Medieval Sharp, and New Rocker. The purple example, instead, features the omnipresent Lobster Two font and the Ysabeau family. As indicated in the readme, they're all OFL fonts on Google Fonts, but I advise downloading Ysabeau from its GitHub repo to get all the variants. In case anyone else has a similar question, [I have uploaded all the configurations on my personal repo](https://github.com/torchipeppo/p3-clock-for-cinnamon/tree/master/custom_compendium) as JSON files that can be easily opened and inspected to find the specified fonts. Thank you for the feedback!