Skip to main content

i2a creates ASCII art from images right on your terminal.

Project description

i2a creates ASCII art from images right on your terminal.

Installation

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.

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

i2a-1.2.tar.gz (3.6 kB view hashes)

Uploaded Source

Built Distributions

i2a-1.2-py3.6.egg (7.6 kB view hashes)

Uploaded Source

i2a-1.2-py2.7.egg (7.6 kB view hashes)

Uploaded Source

Supported by

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