Python package that provides very simple conversion of images to ASCII.

Run python3 test/runtests.py.

You may see warnings related to unclosed file handles. This is a result of the way Pillow handles files, and there doesn't seem to be much to be done about it.

Install via pip with pip3 install imgii or download the source and run setup.py install.

• requests
• pillow
• colorama

In Python:

>>> from imgii import image_to_ascii
>>> image = image_to_ascii('image.png')
>>> print(image)

Here's the relevant function declaration:

image_to_ascii(image_file, output_width=None, console_width=None, scale=2, invert=False, url=False, chars=CHARS, color=False)

From the console:

$ imgii image.png

You can view the available flags by passing -h.

By default, imgii will attempt to scale the image appropriately based on the size of your console. You may also specify the console width with the console_width argument.

Alternatively, you may manually specify the output width of the image (in characters) by passing the output_width argument. (Note that this may result in small images being stretched.)

By default, images are also scaled under the assumption that output characters are twice as tall as they are wide (as this is true for most terminals). This can be undone by passing scale=1.

Any image identifier beginning with http:// or https:// is assumed to be a web URL. An external URL can also be displayed by passing url=True.

If you're displaying the image in a light terminal with dark text (that is to say: if you're a monster), you may also want to pass invert=True.

Some basic ANSI colour support is also provided, but it's kind of hit-or-miss. Pass color=True to try it out.

Two character sets are available by default:

1. imgii.CHARS is the default ASCII character set.
2. imgii.BLOCKS is an alternate character set using a limited number of Unicode block elements.

Custom character sets are also supported, and may be passed in with the chars argument.

• Improve colour support with the extended colour space.

• Not really a bug, but keep in mind that some common Terminal fonts don't fully support the Unicode block character set

There is at least one other image-to-text conversion tool available on PyPI, but it was broken when I needed it. ¯\_(ツ)_/¯

Written by Gem Newman. Website | GitHub | Twitter

This work is licensed under the Mozilla Public License 2.0.

Remember: GitHub is not my CV.