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
MongoDB Atlas runs apps anywhere Icon
MongoDB Atlas runs apps anywhere

Deploy in 115+ regions with the modern database for every enterprise.

MongoDB Atlas gives you the freedom to build and run modern applications anywhere—across AWS, Azure, and Google Cloud. With global availability in over 115 regions, Atlas lets you deploy close to your users, meet compliance needs, and scale with confidence across any geography.
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

18 hours ago
Report inappropriate content