Skip to content

docs: re-cut the TUI GIF so you can actually read it - #108

Open
DLANSAMA wants to merge 1 commit into
mainfrom
docs/tui-gif-recut
Open

docs: re-cut the TUI GIF so you can actually read it#108
DLANSAMA wants to merge 1 commit into
mainfrom
docs/tui-gif-recut

Conversation

@DLANSAMA

@DLANSAMA DLANSAMA commented Aug 6, 2026

Copy link
Copy Markdown
Owner

The GIF that landed in #107 was unreadable. This replaces it.

What was wrong

I recorded it in a 31-row window sized for the prepare screen, then used it for the dashboard. Result: content in the top third, two thirds dead space, screens teleporting past before you could read them.

What changed

Re-recorded at 1200x570 — about 103x24. 24 rows is the TUI's supported minimum, which makes it simultaneously the honest framing (it is what a user on a standard terminal sees) and the tightest one that still fits everything.

Holds are longer: 12 s on the dashboard, 9 s on the monitor. That matters for more than reading time — the dashboard's 10 s refresh timer now ticks on camera, so progress moves 69% → 71% mid-shot. A live view that never visibly updates is indistinguishable from a screenshot.

Scope trimmed to the dashboard and job monitor. The README section this sits under is "Watch the printer while it works"; the prepare screen was a third subject competing for the same frame.

Sizing is now documented, with the failure on both sides

vhs Width/Height are pixels, not cells, which is the trap underneath all of this. The tape header now records the working range and what breaks outside it:

  • ~93 columns (the obvious 1100 px) silently records the narrow single-column prepare layout — the opposite of what the restructure was for.
  • 17 rows pushes the dashboard's progress bar out of frame entirely, behind a scrollbar. Below the supported minimum, so not a product bug — but it silently drops the most important element.
  • 31 rows is what made the first cut unreadable.

Still the same real print

Nozzle 219.97 → 220°C, bed 60 → 60°C, layer 115/240, and the monitor's honest "the print keeps going; nothing here can stop it". Frames extracted and read again for this cut — no IP, serial, access code, or home path, and the shell prompt is bare.

No code or docs prose changes; README.md already points at docs/tui.gif, so the file swap is the whole change.

The first cut was recorded in a 31-row window sized for the prepare screen, so
the dashboard floated in a third of the frame with two thirds dead space, and
the whole thing was unreadable.

Re-recorded at 1200x570 — about 103x24. 24 rows is the TUI's supported minimum,
which makes it both the honest framing and the tightest one that still fits
everything, and the holds are longer (12 s on the dashboard, 9 s on the monitor)
so the screens can be read rather than glimpsed. The dashboard's 10 s refresh
timer now ticks on camera: progress moves 69% -> 71% mid-shot, which is the
point of a live view and something a static frame cannot show.

Recorded against the same real print: nozzle 219.97 -> 220C, bed 60 -> 60C,
layer 115/240, and the monitor's "nothing here can stop it" line. Frames
extracted and read again for this cut — no IP, serial, access code or home path.

Sizing is now documented in the tape, including the failure on either side: at
17 rows the dashboard's progress bar scrolls out of frame, and a much taller
window is what made the first cut unreadable.
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