#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

Manually:

git clone https://github.com/profoak/ascii_py
cd ascii_py
python3 setup.py install

If you want to use the gui component: python3 setup_gui.py 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 https://github.com/PySide/pyside-setup/issues/53

Usage

Usage: ascii_py [options]

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