Skip to main content

Display images using escape codes

Project description

-ASCII-art is so 2013.

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

Examples

Lenna displayed with a color depth of 8 bits.

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:

Lenna displayed with a color depth of 24 bits.

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:

Lenna displayed in 16 colors by xchat.

Use the --animate (show the animation once, then exit) or --loop (animate and loop forever) to animate gifs. There is a noticable difference between between terminals of how smooth the animation looks. KDE’s konsole seems to handle it well.

An animated gif shown in a terminal.

Installation

You should have 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 https://github.com/larsjsol/shellpic.git
# install the package
cd shellpic
sudo python setup.py install

Changelog

See CHANGES.rst

Project details


Release history Release notifications

History Node

1.6.2

History Node

1.6.1

History Node

1.6

History Node

1.5

History Node

1.4.1

History Node

1.4

This version
History Node

1.3

History Node

1.2.2

History Node

1.2.1

History Node

1.2

History Node

1.1.1

History Node

1.1

History Node

1.0.2

History Node

1.0.1

History Node

1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
Shellpic-1.3.tar.gz (615.2 kB) Copy SHA256 hash SHA256 Source None Apr 6, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page