Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

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

You can’t perform that action at this time.