Geocal

A command line tool displaying a calendar and ephemeris of a geodate.

Installation

First you need to install Rust:

$ curl https://sh.rustup.rs -sSf | sh

Then you can install the latest stable version with cargo:

$ cargo install geocal

Or the development version by fetching the git repository:

$ git clone git://github.com/vinc/geocal.git
$ cd geocal
$ cargo install --path .

Usage

Run this tool with a latitude, a longitude, and optionally a timestamp, to get a calendar representation of a geodate:

$ geocal 51.1789 -1.8262 1403333333

  +-------------------------+
  | Date         0114-05-24 |
  +-------------------------+
  | So Me Ve Te Ma Ju Sa Lu |
  | 00 01 02 03 04 05 06    |
  | 07 08 09 10 11 12 13 14 |
  | 15 16 17 18 19 20 21    |
  | 22 23 24 25 26 27 28 29 |
  +-------------------------+
  | Time              27:76 |
  +-------------------------+

There's also an ephemeris option:

$ geocal 51.1789 -1.8262 1403333333 --ephem

  +-------------------------+
  | Date         0114-05-24 |
  +-------------------------+
  | So Me Ve Te Ma Ju Sa Lu |
  | 00 01 02 03 04 05 06    |
  | 07 08 09 10 11 12 13 14 |
  | 15 16 17 18 19 20 21    |
  | 22 23 24 25 26 27 28 29 |
  +-------------------------+
  | Time              27:76 |
  +-------------------------+
  | Moonrise          01:57 |
  | Sunrise           15:46 |
  | Solstice          44:61 |
  | Moonset           58:86 |
  | Sunset            84:53 |
  +-------------------------+

And a solar calendar option instead of the lunisolar calendar to keep track of the seasons:

$ geocal 51.1789 -1.8262 1403333333 --ephem --solar

  +-------------------------------+
  | Date               0114-02-00 |
  +-------------------------------+
  | So Me Ve Te Ma Ju Sa Ur Ne Lu |
  | 00 01 02 03 04 05 06 07 08 09 |
  | 10 11 12 13 14 15 16 17 18 19 |
  | 20 21 22 23 24 25 26 27 28 29 |
  | 30 31 32 33 34 35 36 37 38 39 |
  | 40 41 42 43 44 45 46 47 48 49 |
  | 50 51 52 53 54 55 56 57 58 59 |
  | 60 61 62 63 64 65 66 67 68 69 |
  | 70 71 72 73 74 75 76 77 78 79 |
  | 80 81 82 83 84 85 86 87 88 89 |
  | 90 91 92 93                   |
  +-------------------------------+
  | Time                    27:76 |
  +-------------------------------+
  | Moonrise                01:57 |
  | Sunrise                 15:46 |
  | Solstice                44:61 |
  | Moonset                 58:86 |
  | Sunset                  84:53 |
  +-------------------------------+

License

Copyright (c) 2019-2023 Vincent Ollivier. Released under the MIT License.