Skip to main content

i2a

i2a creates ASCII art from images right on your terminal.

Installation

Step 1: Install dependencies

OSX:

$ brew install libtiff libjpeg webp little-cms2

Linux (Ubuntu):

$ sudo apt-get build-dep python-imaging
$ sudo apt-get install libjpeg8 libjpeg62-dev libfreetype6 libfreetype6-dev

For other operating systems, check out the instructions on this page .

Step 2: Install i2a

Option 1: Pip

$ pip install i2a

Option 2: From source

$ git clone --recursive http://github.com/mavidser/i2a.git
$ cd i2a/
$ python setup.py install

Usage

Basic usage

$ i2a image.jpg

Colored output

$ i2a --colors image.jpg

Write the art to a file

$ i2a image.jpg > ascii.txt

If the terminal has a light background

$ i2a image.jpg --invert

or

$ i2a image.jpg --bg=BLACK

Options

A complete list of available options:

  • --colors : Show colored output. i2a assumes that the terminal supports 256 colors.

  • --bold : Show bold characters. Makes the output is easier on eyes.

  • --invert : Invert the colors. Suitable for a light background.

  • --bg=(BLACK|WHITE): Specify your own background color.

  • --height=<val> : Set the height in number of characters.

  • --width=<val> : Set the width in number of characters.

  • --contrast=<factor> : Manually set contrast (default value: 1.5, for original image: 1.0).

  • --alt-chars : Use an alternate set of (more detailed) characters.

Contributing

  • Create an issue in the issue tracker describing the feature.

  • Fork the project.

  • Create a new branch - git checkout -b new-feature

  • Commit the changes and push to your branch - git push origin new-feature

  • Open a pull request, referencing the issue you created.

License

See the LICENSE file.

Metadata

Release files for i2a 1.3

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

Built distribution (wheel)

Table of built distributions (wheels) for i2a 1.3
File Interpreter ABI Platform Actions
i2a-1.3-py3-none-any.whl Python 3 none any Details for i2a-1.3-py3-none-any.whl

Release files / i2a-1.3-py3-none-any.whl

Download URL i2a-1.3-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4b46069618277642c674b92b4a968b5fc994a8c6edaf89e7c115edfdb9af7bcb
BLAKE2b-256 checksum
How to use checksums
1de2bddc0adb39697bbe790bed3e399b687e0047665085289737720e71b77bd1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.34.0 CPython/3.6.0

Security for i2a 1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3 This release

1 release file No provenance

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