Based on Cinnamon’s [React version](https://github.com/cinnamon-bun/seasonal-hours-clock).
Copy example-config.toml to XDG_CONFIG_HOME/seasonal-clock.toml (XDG_CONFIG_HOME is usually $HOME/.config on Linux systems) and edit it.
Everything configurable should be under the [seasonal-clock] section.
country and city are, well, the country and city you live in. These are optional and will be sent to OpenStreetMap’s Nominatim API to get your exact coordinates unless the coordinates are specified.
latitude and longitude are your exact coordinates; the more accurate the better. These will be sent to OpenStreeMap’s Nominatim API to get your country and city unless they are specified in your config. They will also be used to find the time zone you live in, unless you have that specified in your config.
timezone is the time zone you live your life in.
To show the textual output, use
poetry run print_data.
The output is currently limited to the terminal only (ie. there’s no graphical application or anything to display it.
` Now: 2022-03-24 08:18:24 (UTC 2022-03-24 07:18:24) Morning, 3:30:50.393675 until Noon Next Rāhukāla at 12:22:20 Waning Gibbous Moon rainbow hour (rainbow, 7)`
The first row is the current date and time both in your timezone set, and in UTC (Universal Coordinated Time).
The second row shows the current part of the day, which can be:
- Blue hour (when the Sun is just below the horizon)
- Golden hour (when the Sun is just above the horizon)
- Morning (after the Golden hour until noon)
- Noon (which is actually not 12:00 more often than not)
- Golden hour (when the Sun is still just above the horizon)
- Blue hour (when the Sun is already just below the horizon)
The third row tells you if you are in the period of [Răhukăla](https://en.wikipedia.org/wiki/R%C4%81huk%C4%81la) a part of the day when it’s not favourable to start a good deed, based on the Vedic philosophy.
The fourth row shows you the current phase of the Moon.
The fifth row shows you the seasonal hour.
OK, but what is this all about?
To quote the original idea:
> It would be nice if the 24 hours of UTC time each had a short memorable name. > It would make it easier to plan chats with distant friends, since the > hour-names would be synchronized around the world.
> Let's choose a theme like... seasons of the year, just to be confusing. :) > Squish a year into 24 hours starting with the winter solstice at UTC 00, which > we'll call The Candle Hour.
It can theoretically make it easier to synchronize events across multiple time zones without actually knowing the time difference; just tell the other attending parties that you eat your lunch during Ladybug hour, or that your event is taking place between Gourd and Soup hours.
poetry run print_svg command, you will get an image similar to this: