Skip to main content

Shellpic

-ASCII-art is so 2013.

Shellpic uses escape codes to display images in a terminal, IRC or NUTS 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.

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

Farnsworth and imp displayed in 16 colors in a NUTS talker

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.

An animated gif shown in a terminal.

Installation

You should have Pillow (>=1.0) 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

Metadata

Release files for Shellpic 1.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Shellpic 1.6.1
File Size Uploaded
Shellpic-1.6.1.tar.gz 632.3 kB Details

Release files / Shellpic-1.6.1.tar.gz

Download URL Shellpic-1.6.1.tar.gz
Size 632.3 kB
Tags Source
SHA-256 checksum
How to use checksums
359a14699c7d5e7d26315a8f70dbe92c1048b9ad7aaa657186050636a2d64db8
BLAKE2b-256 checksum
How to use checksums
e594b42c4aeeaa7c15e7b77cc038bd658e9751a52e8ea854935abc1e1ced8f76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

1.6.2

This release

1.6.1 This release

1 release file

1.6

1 release file

1.5

1 release file

1.4.1

1 release file

1.4

1 release file

1.3

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2

1 release file

1.1.1

1 release file

1.1

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page