rview

A fast terminal image/video viewer built with Rust and the Kitty graphics protocol.

Browse directories of images and videos in a thumbnail gallery, search by filename with fuzzy matching, and view media fullscreen — all without leaving the terminal.

Install

cargo install --path .

With video playback support (requires system ffmpeg libraries):

cargo install --path . --features video

Or build from source:

cargo build --release
cargo build --release --features video  # with video support
cp target/release/rview ~/.local/bin/

Usage

rview                              # current directory
rview ~/photos/                    # specific directory
rview image.png                    # single image (fullscreen)
rview photo.jpg screenshot.png     # multiple files
rview -t catppuccin ~/photos/      # choose theme

Controls

Gallery

Key	Action
h j k l	Navigate grid
Enter	Open fullscreen
/	Search filenames
?	Help
q Esc	Quit

Search

Key	Action
Type	Filter by filename (fuzzy)
Enter	Confirm filter
Esc	Cancel and clear
Backspace	Delete character

Fullscreen

Key	Action
h l ← →	Previous / next image
Esc	Back to gallery
?	Help
q	Quit

Video Playback

Key	Action
Space	Pause / resume
h l ← →	Previous / next file
Esc	Back to gallery
?	Help
q	Quit

Themes

Five built-in color themes: tokyonight (default), dark, light, catppuccin, nord.

rview -t nord

Supported Formats

Images: PNG, JPEG, GIF, WebP, BMP, TIFF, ICO, AVIF, and more via the image crate.

Video (with video feature): MP4, MOV, MKV, AVI, WebM, M4V. Videos play at up to 10fps using PNG-encoded frames over the Kitty protocol. Videos loop automatically and show first-frame thumbnails in the gallery.

Requirements

A terminal with Kitty graphics protocol support:

• Kitty
• WezTerm
• Ghostty

For video support: system ffmpeg libraries (ffmpeg 7+).

License

MIT