i2a creates ASCII art from images right on your terminal.
$ brew install libtiff libjpeg webp little-cms2
$ 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.
Option 1: Pip
$ pip install i2a
$ git clone https://github.com/mavidser/i2a.git
$ cd i2a/
$ python setup.py install
$ i2a image.jpg
$ i2a --colors --bold image.jpg #Bold for making the output prettier
$ i2a image.jpg > ascii.txt #Use no filters like bold, color, or bg when writing to a file
$ i2a image.jpg --invert
or
$ i2a image.jpg --bg=BLACK
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.
- 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.
See the releases page.
See the LICENSE file.