This directory holds the tooling for regenerating the static screenshots referenced from docs/03_features.md. Animated GIFs are out of scope.

• freeze — renders a terminal capture to SVG and PNG:

  brew install charmbracelet/tap/freeze

• zellij — terminal multiplexer; runs lnav in a real PTY so its TUI initializes correctly:

  brew install zellij

• A working lnav binary. By default generate.sh looks for build/dev/src/lnav relative to the repo root (the CMake dev build) and falls back to whatever lnav is on PATH. To force a specific binary:

  LNAV_BIN=/path/to/lnav ./generate.sh

Regenerate all screenshots:

./generate.sh

Regenerate one or more by name:

./generate.sh timeline hist

Available shot names: multi_file, hist, timeline, before_pretty, after_pretty, query.

Output goes into ../assets/images/ as both .svg (primary) and .png (fallback). The <picture> blocks in 03_features.md reference both.

All shots share the appearance defined in freeze.json (font, padding, theme, window chrome). Tweak that file to adjust the look of every screenshot at once.

Each screenshot is defined as a shot_<name> function in generate.sh. To add a new shot:

1. Add a shot_<name> function that invokes render <slug> "<lnav command>".
2. Append the name to the ALL_SHOTS array.
3. Reference the new image from 03_features.md as a <picture> block.