Skip to main content

Convert images to beautiful ANSI escape codes

Project description


Convert images to beautiful ANSI escape codes for display in command line interfaces.

Available as both a CLI application and a Python library.



  • 8/16/256/Truecolor supports
  • Custom system color palettes
  • Toggleable Unicode mode, allowing up to 4x more detail
  • Custom output size

Example usage


$ climage --unicode --truecolor --cols 80 barney.jpg


For more detail and available options, run $ climage --help.


import climage

output = climage.convert('image.png', is_unicode=True)

# Converting downloaded file
from PIL import Image
import requests
response = requests.get('')
# Convert to RGB, as files on the Internet may be greyscale, which are not
# supported.
img ='RGB')
# Convert the image to 80col, in 256 color mode, using unicode for higher def.
converted = climage.convert_pil(img, is_unicode=True)

# Convert the image into 50px * 50px, as the convert_array function does not
# perform resizing.
img ='image.png').convert('RGB').resize((50, 50))
arr = np.array(img)
output = climage.convert_array(arr, is_unicode=True)

View additional examples on the project homepage.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

climage-0.2.0.tar.gz (23.1 kB view hashes)

Uploaded Source

Built Distribution

climage-0.2.0-py3-none-any.whl (21.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page