nhmoon is a Rust program for viewing & scrolling
through a slice of the calendar in your terminal. Days with new or full
moons in NetHack are highlighted, though the code can easily be
adjusted to use different highlighting criteria instead.
Screenshot of the program on startup on 2025 February 4:
In order to install nhmoon, you first need to have Rust and Cargo
installed. You can then build the
latest version of nhmoon and install it in ~/.cargo/bin by running:
cargo install --git https://github.com/jwodder/nhmoon
nhmoon [<date>]
Opens a view of a proleptic Gregorian calendar centered on the given date, or
centered on the current date if no date is given. Dates are given in the form
YYYY-MM-DD using astronomical year numbering. Only dates from
10,000 BC (-9999 in astronomical year numbering) through 9,999 AD are
supported.
The calendar highlights dates of NetHack full moons in bold yellow and new moons in bright blue.
| Key | Command |
|---|---|
| k, Up | Scroll up one week |
| j, Down | Scroll down one week |
| w, Page Up | Scroll up one page |
| z, Page Down | Scroll down one page |
| 0, Home | Jump to today |
| g | Input a date to jump to |
| ? | Show help |
| q, Escape | Quit |
Pressing g brings up an input prompt for entering a date in the form
YYYY-MM-DD. (Enter digits only; the hyphens are filled in for you.)
Pressing - or + at the beginning of the prompt changes
the sign of the year. Pressing g, q, or
Escape at any point while editing dismisses the prompt. After
entering eight digits, press Enter to jump to the given date.