by ProfOak

ProfOak / ascii_py

Make some ascii arts

206 Stars 16 Forks Last release: over 4 years ago (1.2) MIT License 38 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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 -o FILENAME, --out=FILENAME 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 density -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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.