Skip to content

docs: animated TUI demo GIF as the README preview#138

Merged
lance0 merged 1 commit into
masterfrom
docs/demo-gif
Jul 7, 2026
Merged

docs: animated TUI demo GIF as the README preview#138
lance0 merged 1 commit into
masterfrom
docs/demo-gif

Conversation

@lance0

@lance0 lance0 commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Replaces the static xfr-ss.png screenshot with a recorded GIF of the live TUI.

xfr live TUI demo

What it shows

A rate-limited (-b 1G) TCP test against a local xfr serve — the real-time throughput graph, per-second speed / RTT / retransmit stats and progress bar, then a peek at the Settings modal (theme picker + the new Update check toggle), holding on the live graph.

Reproducibility

Rendered with VHS from docs/demo.tape (steps in its header):

cargo build
./target/debug/xfr serve >/dev/null 2>&1 &
PATH="$PWD/target/debug:$PATH" vhs docs/demo.tape

The tape launches into a throwaway HOME, so the demo is deterministic (default theme, no saved prefs) and never touches real config — this is why an earlier draft went grey (a persisted theme = monochrome leaked in from a prior run).

Verified

Every beat checked frame-by-frame (ffmpeg stills): live graph at 8s, Settings + toggle at 15s, final graph hold at 20s — all render with real data in the colorful default theme, no "Loading…"/blank frames, and the GIF ends on the TUI (quit happens off-camera). 20.9s, ~198 KB.

Replace the static xfr-ss.png screenshot with a VHS-recorded GIF of the live
TUI: a rate-limited (-b 1G) TCP test against a local server showing the
real-time throughput graph, per-second speed/RTT/retransmit stats, and the
Settings modal. Rendered from docs/demo.tape (reproduce steps in its header);
runs in a throwaway HOME so it is deterministic and touches no real config.
@lance0
lance0 merged commit 0d1b26f into master Jul 7, 2026
16 checks passed
@lance0
lance0 deleted the docs/demo-gif branch July 7, 2026 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant