Environment
ratatui-image 11.0.6, ratatui 0.30.2
- Terminal: iTerm2
- macOS (Darwin 25.5), iTerm2 version:
Build 3.6.11
- Rendering via the static
Image + Picker::new_protocol(...) path (not StatefulImage)
Summary
When rendering a cover image with the iTerm2 protocol, the image displays correctly as long as the window stays focused. If the iTerm2 window/tab is moved to a background tab, after some time (often a few minutes) the inline image disappears and the affected region degrades into a black/garbled box that the app never repairs on its own
Steps to reproduce
- Render a cover image each frame in a normal ratatui draw loop using
Image::new(&protocol)
- Run in iTerm2.
- Cover the iTerm2 window with another app (or switch to a different tab) and leave it for a few minutes.
- Bring it back to the foreground.
Expected: TUI looks normal.
Actual: TUI's screen goes black and no redraw restores it.
Environment
ratatui-image11.0.6,ratatui0.30.2Build 3.6.11Image+Picker::new_protocol(...)path (notStatefulImage)Summary
When rendering a cover image with the iTerm2 protocol, the image displays correctly as long as the window stays focused. If the iTerm2 window/tab is moved to a background tab, after some time (often a few minutes) the inline image disappears and the affected region degrades into a black/garbled box that the app never repairs on its own
Steps to reproduce
Image::new(&protocol)Expected: TUI looks normal.
Actual: TUI's screen goes black and no redraw restores it.