viu
Display images in the terminal
TLDR
Display image
SYNOPSIS
viu [-w width] [-h height] [options] files
DESCRIPTION
viu is a terminal image viewer written in Rust that renders images directly in the terminal using Unicode half-block characters and 24-bit ANSI color codes. It supports common image formats including PNG, JPEG, GIF, WebP, and BMP, displaying them at a resolution determined by the terminal's character grid.
Output dimensions can be controlled with width and height options, and aspect ratio is preserved by default when only one dimension is specified. An alternative block rendering mode uses full block characters for a different visual density, and transparent backgrounds can be enabled for images with alpha channels.
Animated GIFs play directly in the terminal with configurable frame rates. The tool also reads from standard input, enabling pipeline integration where images can be fetched with curl or generated by other programs and piped directly to viu for display.
PARAMETERS
-w, --width N
Output width.-h, --height N
Output height.-b, --blocks
Use full blocks.-t, --transparent
Transparent background.-n, --name
Show filename.-r, --recursive
Recursive directory.-f, --frame-rate N
GIF frame rate.
CAVEATS
Quality depends on terminal. True color support improves output. Large images slow.
HISTORY
viu is a Rust-based terminal image viewer. It provides fast, high-quality image display in modern terminals.
