Documentation
¶
Overview ¶
imgspike is a diagnostic harness for inline image rendering inside a bubbletea TUI. Earlier attempts to show Kitty Graphics images in the rdr Reader failed after six iterations (reverted in commit db0034a) with the byte dump looking correct but no image appearing on screen. Rather than re-attempt inside the full reader, this tool isolates the problem: we build the minimal possible bubbletea program that tries to render one Kitty image, then grow it one layer at a time until it breaks, so we can pinpoint which layer (alt-screen / viewport / lipgloss) is the actual blocker.
Run:
go run ./cmd/imgspike -img path/to/picture.jpg -mode 1a go run ./cmd/imgspike -img path/to/picture.jpg -mode 1b go run ./cmd/imgspike -img path/to/picture.jpg -mode 1c
Exit with q or ctrl+c. If the image is visible above "---bottom---" the mode works. Set RDR_DUMP_VIEW=<file> to also capture every View() output to disk for byte-level inspection.
Source Files