Imgtoascii

A program that converts images into ASCII art

Requirements

• Python3
• Pillow

Usage

Clone the project and run pip install and py main.py image_path

Available options:

• --cols columns (or width) of the output image

  If the art is printed to terminal and cols exceedes terminal width, it will automatically resize to fit, same if the specified width exceeds the original width

• --color print colored characters instead of monochrome

  Works when priting to terminal or saving as png, not when saving as file

• --fill use filled characters instead of letters and symbols

  Works when priting to terminal, saving as text file or saving as png, both color and monochrome

• --chars characters to use instead of default grayscale

  Works when priting to terminal not when saving as file or png, both color and monochrome

• --output print result in the specified file

• --png save ASCII art as PNG image

Examples

Monochrome

Color

Fill

Characters

References

• Pillow
• Paul Bourke grayscale
• ProfOak Ascii_py
• How does image to ascii work