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 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