ASCII-art

A program to turn images into ASCII-art. It is created by printing characters to your terminal so as to recreate the contours of a source image.

Dependencies

All of the dependencies can be installed via pip

• PIL
• colorama
• argparse

Usage

download ASCIIart.py and execute:

python ASCIIart.py [-h] [-c] [-i] [-m {0,1,2}] [-ws WIDTH] [-hs HEIGHT]
                   filename

• positional arguments:

  • filename

• optional arguments:

  • -h, --help : show this help message and exit
  • -c, --color : ASCII art in glorious color
  • -i, --invert : invert all the brightnesses
  • -m {0,1,2}, --map {0,1,2} : brightness mappings: 0 for average, 1 for lightness, 2 for luminosity
  • -ws WIDTH, --width WIDTH : width of the screen
  • -hs HEIGHT, --height HEIGHT : height of the screen

  Use trial and error to work out the largest image that you can display on your terminal by using params -ws and -hs.

Features

• Set RGB mappings in 3 styles (average, lightness, luminosity)

• invert brightness

  

• 8 color pallete

  

Acknowledgments

Gratitude to Robert Heaton for inspiring me to do this project. Head to his blog post, if you want to build ASCII-art from scratch.

License

This project is licensed under the MIT License - see the LICENSE file for details