Repository navigation
Render local images in the Kitty TUI - #309
Closed
FelixZhang wants to merge 2 commits into
Closed
FelixZhang wants to merge 2 commits into
FelixZhang wants to merge 2 commits into
Conversation
added 2 commits
September 28, 2026 17:11
Add aspect-aware Markdown image blocks, background decoding, bounded caching, and Kitty graphics rendering. Preserve readable fallbacks for unsupported images and non-Kitty terminals.
Add a default-disabled kitty-images setting and i/I session toggle. Disabled mode follows upstream text layout, while enabled mode reparses image blocks and cancels background workers safely.
FelixZhang
force-pushed
the
feat/kitty-tui-images
branch
from
September 28, 2026 09:12
ce7970f to
b89c0d4
Compare
Owner
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds optional local image rendering to the interactive TUI using Kitty's graphics protocol. Rendering is disabled by default and can be enabled through configuration, environment, or an in-session hotkey.
Changes
kitty-imagesconfiguration withLEAF_KITTY_IMAGESoverride; both default to disabled.i/Isession toggle with status feedback and help entry.into image blocks only when image rendering is enabled.ratatui-image.--inlineoutput unchanged and free of Kitty control sequences.Notes
data:URLs, and SVG files are not downloaded or rendered.Testing
cargo fmt --all -- --checkcargo test(540 tests)cargo clippy --all-targets --all-features -- -D warningscargo build --release--inlinecontains no Kitty APC sequencesTESTING.md