# sindresorhus/terminal-image

Display images in the terminal

Repository: https://github.com/sindresorhus/terminal-image
Canonical: https://ross.abutalabs.com/products/terminal-image
Language: JavaScript
License: MIT
License Family: permissive
Topics: terminal-image, image, cli-utility, nodejs, npm-package
Last push: 2026-07-09T10:04:34+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 80, longevity 100
- inputs: {"age_days": 3039, "days_push": 55, "days_rel": 55, "gap_med": 77, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1129, forks 29 (observed 2026-08-28T04:03:42.177067+00:00)

## What it is
A Node.js library that displays images (PNG, JPEG, and animated GIFs) directly in the terminal using ANSI escape codes or native terminal graphics protocols. It supports iTerm, Kitty, WezTerm, and other terminals with graphics support, falling back to ANSI block characters elsewhere.

## Use cases
- show an image in the terminal from a node script
- preview jpg and png files without leaving the command line
- render animated gifs inside a terminal app
- display images in a cli tool output
- scale images to fit terminal width and height
- use native terminal image protocols like kitty or iterm

## When to avoid
- you need image display in a non-Node.js environment
- you need a standalone CLI binary rather than a library
- your terminal does not support colors or graphics protocols

## Facets
- artifact type: library
- maturity: active
- function: image-processing, cli, developer-tools
- domain: developer-tools, media
- platform: cli, cross-platform
- tags: terminal-graphics, ansi-art, iterm-protocol, kitty-graphics, gif-animation, command-line, nodejs

## Member repositories
- sindresorhus/terminal-image (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:42.177067+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:38:27.592163+00:00, confidence not recorded.
  - readme: https://github.com/sindresorhus/terminal-image (fetched 2026-08-28T04:03:42.177067+00:00, sha e09b43e52988)
  - registry_npm: https://registry.npmjs.org/terminal-image (fetched 2026-08-29T12:43:04.489757+00:00, sha 6cea6fcd826b)
- Data as of 2026-08-30T08:39:29.467469+00:00.