Make some ascii arts
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
ascii_py added directories to reflect. May 31, 2016
LICENSE made readme more clear on how to use ascii py Jul 15, 2016

#Ascii Py

Makin some pictures

Ascii py requires the use of Python 3.3 or greater because of an addition made to the shutil ibrary.

Install instructions

Using pip:

python3 -m pip install ascii_py


git clone
cd ascii_py
python3 install

If you want to use the gui component: python3 install

This library requires the Pillow and colorama libraries. If you use the above install methods, these will automagically be installed.

python3 -m pip install -U Pillow colorama

To use the gui you need PySide

python3 -m pip install -U PySide

At the time of this commit PySide can only be installed on Python versions 2.6, 2.7, 3.3, 3.4. If you wish to use the GUI you must have installed versions 3.3 or 3.4. You can read more about it here


Usage: ascii_py [options]


  -h, --help            show this help message and exit
                        The filename you want your final image saved as
  -w WORDS, --words=WORDS
                        Use words to create your image
  -s STEP, --step=STEP  Choose the distance of your characters
  -d, --density         Adding the flag converts the image based on visual
  -t, --terminal        Print ascii image to terminal

Example images

Original image:

Default usage:

Density flag:

Terminal flag (screenshot):

Other flags usage example:

$ ascii_py -s 10 -w "dank memes" -o ayy_lmao_pizza.jpg Media/pizza_in.jpg