terminal-image-cli

September 11, 2025 ยท View on GitHub

Display images in the terminal

Works in any terminal that supports colors. Supports animated GIFs.

In iTerm, Kitty, WezTerm, and other terminals with graphics support, the image will be displayed in full resolution. In other terminals, it will be rendered using ANSI block characters.

Install

npm install --global terminal-image-cli

Usage

$ image --help

  Usage
    $ image <image>
    $ cat <image> | image

  Examples
    $ image unicorn.jpg
    $ cat unicorn.jpg | image