Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Display images using escape codes

Project Description

-ASCII-art is so 2013.

Shellpic uses escape codes to display images in a terminal, IRC or NUTS client.

Examples

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:

The --nuts-switch will do the same, but for NUTS talkers. This is how it looks in konsole:

The --tinymux-switch will also do that, generating 256 color images for TinyMUX servers.

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.

Installation

You should have Pillow (>=2.6) and python development files installed. Shellpic works with Python 2.6, 2.7, 3.3 and 3.4. It will not work with Python 2.5 or 3.2.

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
# optional - run tests
./shellpic/tests/run_tests.sh
# install the package
cd shellpic
sudo python setup.py install

Changelog

See CHANGES.rst

Release History

Release History

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

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

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting