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

Project Activity

See All Activity >

Categories

Terminals

License

MIT License

Follow terminal-image

terminal-image Web Site

Other Useful Business Software
Build Agents and Models on One Platform Icon
Build Agents and Models on One Platform

Everything you need to build production-ready agents and models. Access 200+ Google and third-party AI models and tools.

Gemini Enterprise Agent Platform is Google Cloud's comprehensive platform for developers to build, scale, govern, and optimize agents and models. Choose from Google's most advanced models and third-party models like Anthropic's Claude Model Family.
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