Skip to content
/ img Public

Print images in the terminal

Notifications You must be signed in to change notification settings

oysols/img

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

img

Print images in the terminal using ANSI codes

Screenshot

  • Sets foreground and background color of half block unicode "▄" to represent two pixels for each character
  • Matches colors with closest ANSI extended color (16-231)
  • Color lookup table for quick rendering of large images
  • Depends on Pillow for image processing

Features

  • List all images in current dir with thumbnails and filenames img
  • Print single image to fit terminal img image.jpg
  • Custom size options --cols and/or --rows
  • Accepts raw image data over stdin cat image.jpg | img -
  • img.process_image(path) returns the image rows as strings

CLI Tool Installation

pipx install "git+https://github.com/oysols/img"

About

Print images in the terminal

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages