Opens local PNG, JPEG, WebP and GIF files in ordinary Neovim windows using the Kitty graphics protocol.
PNG files are read directly.
Other formats use FFmpeg from PATH to prepare a cached, first-frame RGBA PNG.
No Snacks or ImageMagick dependency.
Requirements
Neovim 0.12 terminal UI and a Kitty-graphics-capable terminal.
FFmpeg is required only for non-PNG images.
Unix cell dimensions come from the terminal's native window-size report.
WezTerm uses its CLI and WEZTERM_PANE to obtain actual pane pixel dimensions on any OS.
Its incomplete proportional-sizing support is handled with explicit cell rectangles and minimized cell-grid distortion.
Missing or zero measurements produce an error instead of guessed geometry.
Neovide and image buffers inside floating windows are outside this viewer's scope.
Behavior
Images fit the text viewport without enlarging beyond their source dimensions, subject to a minimum terminal cell.
Each window owns a separate placement; image data is shared while visible.
Overlapping native floats temporarily hide the affected image.
Hidden images release terminal storage; prepared raster files remain cached.
Writes to image buffers are rejected.
Window presentation settings live in after/ftplugin/image.lua.
Incline's image exclusion lives in lua/bugabinga/winbar.lua.
Neither policy is built into the renderer.
The conversion cache is stdpath('cache')/bugabinga-image.
Cache keys include source path, size, modification time and conversion version.
Cache files persist without automatic size eviction.
Conversions have a 30-second deadline, a 100-million-pixel limit and 100-MiB source/output checks.
Large PNG uploads are streamed synchronously in bounded protocol chunks and can briefly occupy Neovim's event loop.
Call :lua BugabingaImage.refresh() to remeasure and retransmit after an external terminal reset.
Resize and focus/resume events refresh automatically.
Owned terminal decoding errors are reported when the terminal forwards protocol replies.
Provenance
Modified derivative of folke/snacks.nvim's image implementation.
Upstream commit, changes and Apache-2.0 license are recorded in NOTICE and LICENSE.
# Image buffers
Opens local PNG, JPEG, WebP and GIF files in ordinary Neovim windows using the Kitty graphics protocol.
PNG files are read directly.
Other formats use FFmpeg from PATH to prepare a cached, first-frame RGBA PNG.
No Snacks or ImageMagick dependency.
## Requirements
Neovim 0.12 terminal UI and a Kitty-graphics-capable terminal.
FFmpeg is required only for non-PNG images.
Unix cell dimensions come from the terminal's native window-size report.
WezTerm uses its CLI and WEZTERM_PANE to obtain actual pane pixel dimensions on any OS.
Its incomplete proportional-sizing support is handled with explicit cell rectangles and minimized cell-grid distortion.
Missing or zero measurements produce an error instead of guessed geometry.
Neovide and image buffers inside floating windows are outside this viewer's scope.
## Behavior
Images fit the text viewport without enlarging beyond their source dimensions, subject to a minimum terminal cell.
Each window owns a separate placement; image data is shared while visible.
Overlapping native floats temporarily hide the affected image.
Hidden images release terminal storage; prepared raster files remain cached.
Writes to image buffers are rejected.
Window presentation settings live in after/ftplugin/image.lua.
Incline's image exclusion lives in lua/bugabinga/winbar.lua.
Neither policy is built into the renderer.
The conversion cache is stdpath('cache')/bugabinga-image.
Cache keys include source path, size, modification time and conversion version.
Cache files persist without automatic size eviction.
Conversions have a 30-second deadline, a 100-million-pixel limit and 100-MiB source/output checks.
Large PNG uploads are streamed synchronously in bounded protocol chunks and can briefly occupy Neovim's event loop.
Call :lua BugabingaImage.refresh() to remeasure and retransmit after an external terminal reset.
Resize and focus/resume events refresh automatically.
Owned terminal decoding errors are reported when the terminal forwards protocol replies.
## Provenance
Modified derivative of folke/snacks.nvim's image implementation.
Upstream commit, changes and Apache-2.0 license are recorded in NOTICE and LICENSE.