# terminal-image-cli

> Display images in the terminal

Latest version **5.0.0** (published 2026-07-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install terminal-image-cli
pnpm add terminal-image-cli
yarn add terminal-image-cli
bun add terminal-image-cli
```

Provides the command `image`.

## Health

**Score 55/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 5.0.0 |
| Published | 2026-07-09 |
| First published | 2018-05-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 4 |
| Unpacked size | 3.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 280 |
| Author | Sindre Sorhus |
| Maintainers | sindresorhus |
| Keywords | cli-app, cli, image, terminal, ansi, escape, png, jpg, jpeg, gif, animated, animation |

## Links

- npm: https://www.npmjs.com/package/terminal-image-cli
- Repository: https://github.com/sindresorhus/terminal-image-cli
- Homepage: https://github.com/sindresorhus/terminal-image-cli#readme
- Issues: https://github.com/sindresorhus/terminal-image-cli/issues
- Funding: https://github.com/sponsors/sindresorhus
- npm.io page: https://npm.io/package/terminal-image-cli

## Dependencies (4)

- [meow](https://npm.io/package/meow.md) ^14.1.0
- [file-type](https://npm.io/package/file-type.md) ^22.0.1
- [get-stdin](https://npm.io/package/get-stdin.md) ^10.0.0
- [terminal-image](https://npm.io/package/terminal-image.md) ^5.0.1

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 5.0.0 (latest) — 2026-07-09
- 4.0.0 — 2025-09-11
- 3.0.0 — 2024-07-26
- 2.0.0 — 2021-05-03
- 1.1.0 — 2020-07-18
- 1.0.0 — 2020-05-10
- 0.1.1 — 2018-08-27
- 0.1.0 — 2018-05-08

## README

# terminal-image-cli

> Display images in the terminal

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

<img src="screenshot.png" width="1082">

*In iTerm, Kitty, WezTerm, and other terminals with graphics support, the image will be [displayed in full resolution](screenshot-iterm.jpg). In other terminals, it will be rendered using ANSI block characters.*

## Install

```sh
npm install --global terminal-image-cli
```

## Usage

```text
$ image --help

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

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

## Related

- [terminal-image](https://github.com/sindresorhus/terminal-image) - API for this package
- [terminal-link-cli](https://github.com/sindresorhus/terminal-link-cli) - Create clickable links in the terminal

---
_Source: https://npm.io/package/terminal-image-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._