Skip to main content

Python libray for displaying images on terminal

Project description


Python library for displaying image on terminal.

Actions Status PyPI version MIT licensed


$ pip


import numpy as np
from teimpy import get_drawer, Mode

R = np.array([1.0, 0, 0])
G = np.array([0, 1.0, 0])
B = np.array([0, 0, 1.0])

def _get_color(x, y):
    tmp = (y * (1.0 - x) * R + (1.0 -y ) * x * G + (1.0 - y) * (1.0 - x) * B)
    return (255 * tmp).astype(np.uint8)

tics = np.linspace(0, 1, 128)
xs, ys = np.meshgrid(tics, tics)
buffer = np.vectorize(_get_color, signature='(),()->(3)')(xs, ys)

Result of


  • Resize images to fit terminal size.
  • Drawing with iterm2 inline image. Drawing with iterm2 inline image
  • Drawing with Braille fonts. Drawing with Braille ofnts
  • Drawing with half block fonts. Drawing with half block fonts


This software is released under the MIT License, see LICENSE.

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

teimpy-0.1.1.tar.gz (15.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page