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.

An animated gif shown in a terminal.

Install

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

Project details


Download files

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

Source Distribution

Shellpic-1.2.1.tar.gz (612.9 kB view details)

Uploaded Source

File details

Details for the file Shellpic-1.2.1.tar.gz.

File metadata

  • Download URL: Shellpic-1.2.1.tar.gz
  • Upload date:
  • Size: 612.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Shellpic-1.2.1.tar.gz
Algorithm Hash digest
SHA256 f52419589263e4c20e13024198ea5bc4fe3e2fec64c8667b4640c4b05c041fa3
MD5 fac4fb2ac2bccbfcfc4372afc1b47e22
BLAKE2b-256 697026d96655488b926d1a3f9d5acc9087a39982728779699575829fe51a67c4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page