Files
Alex JonesandAlex Jones 78f05e7bfd docs: new README demo GIF, recorded from a reproducible VHS tape (#1068)
* docs: new README demo GIF, recorded from a reproducible VHS tape

The old demo.gif was 856x705 at about 2 fps over 46 s, and predates most
of the current TUI.

The new one is 1527x841 at 20 fps over 31 s and is smaller (1.30 MB vs
1.50 MB). It tells one story with 1.1.16: the default ranked list, a
search for the newly added zai-org/GLM-5.3 (too tight on the recording
machine), hardware simulation turning it into a fit, the detail view, the
plan view, then theme cycling.

assets/demo.tape and scripts/record_demo.sh make it re-recordable for
future releases. The script encodes the GIF itself rather than letting
VHS do it: dither=none keeps flat terminal colours clean (dithering is
what makes terminal GIFs grainy, and it bloats them), and 20 fps is an
exact GIF delay so playback speed is right. It also works around two VHS
0.12 problems hit while recording: its encode step fails silently against
ffmpeg 9, and its frame output fails silently when the destination is on
a different filesystem from its temp dir.

* docs: move the demo above Features and start it on the loaded TUI

The GIF sat at the end of the Sister projects section, where it read as
belonging to those projects. It now sits directly above Features, with
descriptive alt text, and the Features heading gets the blank line it was
missing.

The recording opened with the prompt and then a 'Loading: Detecting system
hardware...' screen until about 2.9 s, which is dead time in a looping
README GIF. The launch now happens inside the tape's hidden setup, so the
first visible frame is the loaded TUI. 29 s, was 31 s.

* docs(demo): make record_demo.sh work on macOS and clean up on early exit

Review follow-ups on #1068:
- `mktemp --suffix` is GNU-only, so the script died on macOS, the platform
  its `brew install vhs` instruction points at. The palette now lives in
  the temp working directory.
- The EXIT trap is registered as soon as that directory exists, so a
  missing dependency or a failed recording leaves nothing behind, and the
  tape's throwaway config dir moves under it too.

---------

Co-authored-by: Alex Jones <axjns@example.com>
2026-09-20 07:50:49 +01:00
..
2026-03-03 14:16:31 +00:00