LinuxCommandLibrary

viu

Display images in the terminal

TLDR

Display image

$ viu [image.png]
copy
Set width
$ viu -w [80] [image.png]
copy
Set height
$ viu -h [40] [image.png]
copy
Display multiple images
$ viu [image1.png] [image2.png]
copy
Use blocks instead of half-blocks
$ viu -b [image.png]
copy
Transparent background
$ viu -t [image.png]
copy
From stdin
$ cat [image.png] | viu -
copy

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.

SEE ALSO

chafa(1), catimg(1), tiv(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community