img2txt

Convert image with specific output width (columns)

$ img2txt -W [10] [path/to/image]

$ img2txt -H [5] [path/to/image]

$ img2txt -x [12] [path/to/image]

$ img2txt -y [14] [path/to/image]

$ img2txt -b [2] [path/to/image]

img2txt [options] image

img2txt converts images to colored ASCII art, outputting text that reproduces the image using character patterns and terminal colors. It is part of the libcaca library, which provides ASCII art rendering.
The tool can produce output in various formats including ANSI terminal codes, HTML, IRC color codes, and plain text. The resulting ASCII art can be displayed in terminals or embedded in documents.

-W, --width COLS

Set output width in columns

Set output height in lines

Set assumed font width for aspect ratio

Set assumed font height for aspect ratio

Adjust brightness (default 1.0)

Adjust contrast

Output format (ansi, html, irc, etc.)

Output quality depends on terminal capabilities and font characteristics. Wide characters or non-monospace fonts will distort the output. Color support varies by terminal emulator.

img2txt is part of libcaca, a graphics library for text terminals created by Sam Hocevar. The library was first released in 2003 and has been used in various projects including VLC media player for ASCII video rendering.

cacaview(1), jp2a(1), aview(1)