skip to navigation
skip to content

Shellpic 1.2.1

Display images using escape codes

Latest Version: 1.6.2

-ASCII-art is so 2013.

Shellpic uses escape codes to display images in a terminal or irc-client.


Running shellpic <image> in a terminal that supports 256-colors will get you something that looks like the image above.

If you happen to have a terminal that is capable of showing true colors, you can use the --shell24-switch to enable 24bit output. It will look something like this:

Shellpic can also be used with irc-clients. Run the script from your client and use the --irc-switch, the result will depend on the client used. This is how it looks in xchat:

Use the --animate (show the animation once, then exit) or --loop (animate and loop forever) to animate gifs.


You should have PIL (>=1.1.7) or Pillow (>=1.0) installed. Shellpic is tested with Python 2.7.

If you have PIP installed:

sudo pip install Shellpic

If you do not have PIP or want the bleeding edge version of Shellpic:

# clone the repo
git clone
# install the package
cd shellpic
sudo python install
File Type Py Version Uploaded on Size
Shellpic-1.2.1.tar.gz (md5) Source 2014-03-10 598KB