terminal-image is a Node.js package for displaying images directly inside color-capable terminal applications. It supports PNG and JPEG files as well as animated GIF playback. Terminals with native graphics protocols, including compatible iTerm2 and Kitty environments, can display images at full resolution. Other terminals fall back to colored Unicode block characters using ANSI output. Developers can specify image width and height as terminal dimensions or percentages while preserving aspect ratio by default. The package accepts both image files and in-memory buffers. GIF rendering includes configurable frame-rate limits and custom frame handlers, making the library suitable for rich CLI previews and media-oriented terminal tools.

Features

  • PNG and JPEG terminal rendering
  • Animated GIF playback
  • Kitty and iTerm2 native graphics support
  • ANSI block-character fallback rendering
  • Configurable image dimensions and aspect ratio
  • File and in-memory buffer input

Project Samples

terminal-image Screenshot 1

Project Activity

See All Activity >

Categories

Terminals

License

MIT License

Follow terminal-image

terminal-image Web Site

Other Useful Business Software
$300 Free Credits to Build on Google Cloud Icon
$300 Free Credits to Build on Google Cloud

New customers can spin up VMs, build with AI, and query data at no cost.

Put your $300 in credit toward real workloads, then keep building with free monthly usage for 20+ products. No commitment and no charge until you upgrade.
Start Free
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of terminal-image!

Additional Project Details

Programming Language

JavaScript

Related Categories

JavaScript Terminals

Registered

2026-09-09
Report inappropriate content