Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Render pixel images (including animated GIFs) on 256-color ANSI terminals
Python Shell
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
packaging
pixelterm
.gitignore
LICENSE
README.md
commands.py
example.gif
example.png
nyancat.gif
rainbow-dash.png
setup.py

README.md

PIXELTERM

A utility to render pixely images on your terminal. Now also with animated GIF support*.

animated example example

*for best results, use tmux (for some reason that reduces flickering)

Installation

Although there is a setup.py I have grown quite frustrated with setuptools and pythons abysmal package handling. Any contributions are welcome.

Usage

pixelterm FILE
gifterm FILE

Advanced usage

Since I wrote this tool to generate graphics for ponysay, I included a "speech bubble" feature. To make this tool render speech bubble markers which can later be parsed by ponysay, color the pixels where these should be placed 50% transparent red (#FF00007F) for a backward slash link, 50% blue for a forward slash and a 50% transparent green for the speech bubble. Please note that this tool converts images two pixel rows at once and these "special" color values are only parsed for the upper of the two rows. An example image is included.

Credits

That awesome Rainbow Dash is by starsteppony on deviantart. Credit for pop tart cat/nyan cat goes to prguitarman from tumblr.

Something went wrong with that request. Please try again.