gallery-tui

gallery-tui is a terminal image gallery built with Ratatui. It scans an image folder and displays the images as navigable cards in a TUI.

gallery-tui_demo.mp4

Features

Scrollable image-card gallery with keyboard and mouse focus navigation.
Switchable grid, list, and masonry layouts.
Detail view with large image preview and filesystem/EXIF metadata.
Which-key style hints.
Rename, select, batch path export, refresh, cache clearing, and flexible sort commands.
Terminal graphics support with Kitty, Sixel, iTerm2, Chafa symbols, and ASCII fallback.
SVG support: vector files are rasterized on demand (with resvg) and cached, then rendered like any other image.
On-demand async rendering with zstd-compressed LRU render cache.

gallery-tui /path/to/images
gallery-tui /path/to/image.png
gallery-tui --browser /path/to/image.png

Opening a single image starts in detail view. Pressing q exits immediately; with --browser, q returns to the folder browser instead.

Batch path output from c p is written to stdout after the UI exits, so it can be piped:

gallery-tui ~/Pictures | other-tool

Arch Linux AUR:

yay -S gallery-tui-bin

Alternative AUR packages:

yay -S gallery-tui      # build the latest stable release from source
yay -S gallery-tui-git  # build the latest git version from source

Homebrew:

brew install WindustH/tap/gallery-tui

The Homebrew stable formula downloads a prebuilt release binary. To build the latest git version from source:

brew install --HEAD WindustH/tap/gallery-tui