The Moon as it looks tonight, in the terminal.
The big disk is the near side of the Moon, lit for the phase of the moment: the sunlit part in light gray and white, the night side in dark gray, craters and maria on both. In glass, or any terminal that shows images, the disk is real pixels; elsewhere each cell holds two.
A strip of small Moons along the bottom shows the three days before, the day on screen, and the days ahead until the edge of the window. Today's label is yellow.
Part of the Fe₂O₃ suite. Built on crust (panes) and orbit (phase).
| Key | Action |
|---|---|
← → / h l |
a day back / forward |
t |
back to today |
Tab / m |
the map, and back |
Esc |
back to the Moon |
/ |
find a feature and open the map on it |
f |
naked eye, telescope, star diagonal |
Ctrl+A |
a Claude session about the Moon on screen (claude on the PATH); /exit comes back |
q |
quit |
Tab or m opens a map of the near side with the features
named: the seas in blue, craters in yellow, mountains, valleys and
rilles in tan. Zoom in and more names appear, biggest first, wherever
there is room. The craters that stand out to the naked eye, such as
Tycho, Copernicus, Kepler and Aristarchus, are named on the whole disk.
| Key | Action |
|---|---|
+ - |
zoom in / out, up to 16× |
← ↑ ↓ → / h j k l |
pan |
/ |
find a feature: the map centres on it and marks its name |
0 |
back to the whole disk |
Tab / m |
back to the Moon |
Esc |
back to the Moon |
In a terminal that shows images the map is real pixels, with the names set into the picture. Elsewhere it is braille: every cell holds eight dots in two columns of four, so the map has four times the rows of the phase picture.
The detail map is 2048 pixels across, shaded with the Moon's measured heights and lit from the north-west so craters show their rims. It is compressed into the binary and unpacked the first time it is needed.
The picture is drawn on start, on a key and on a resize. Nothing runs in between.
f turns the picture the way you see it at the eyepiece. It steps from
the naked eye, north up, to a telescope, which shows the Moon upside
down with south up, to a star diagonal, which mirrors it left to right.
The Moon, the phase strip and the map all follow, and the arrows still
pan the way they point.
A search ignores case and accents, so reaumur finds Réaumur. It tries
an exact name first, then one that starts with what you typed, then
one that holds it.
git clone https://github.com/isene/moon
cd moon
cargo build --releasecrust and orbit are expected as sibling checkouts (../crust,
../orbit). Release binaries for Linux and macOS are on the
releases page.
In glass, or any terminal that shows images, the Moon, the strip and the map are drawn through glow from the shaded 2048-pixel map, at the size of the window in pixels.
Elsewhere every cell is a ▀ with one gray for its top half and one
for its bottom, so a 50-row window gives a 100-pixel moon from a
512-pixel map. Both maps are NASA's LRO camera mosaic of the near side,
embedded in the binary.
The phase comes from orbit's mean lunar cycle, so it can be a few hours off the true phase. The Moon's slight wobble (libration) is not drawn; the map is always the mean near side, north up, with the lit side on the right while waxing, as seen from the northern hemisphere.
Moon map: NASA/GSFC/Arizona State University, Lunar Reconnaissance Orbiter (LROC WAC), from the CGI Moon Kit. Public domain.
Heights for the map shading: NASA/GSFC, Lunar Orbiter Laser Altimeter (LOLA), from the same kit. Public domain.
Feature names: the IAU / USGS Gazetteer of Planetary Nomenclature, near side only, without the lettered satellite craters. Public domain.
Public domain (Unlicense).



