asciimage 3.1415926535

ASCII art Python library

asciimage

A library designed in python to convert images into ascii paintings. To install:

pip install asciimage
pip install docx
pip install python-docx

For more examples or if you are still struggling with installation check out the Jupyter notebook
Note: In some cases, you might get the error "No module named 'exceptions'". This is because the docx and python-docx libraries are not installed properly.
You can try the library extensively on Google Colab. Create a copy of this notebook and make edits as necessary.
Also, in case of exception like 'too many values to unpack', try using a jpg image.
This library works best with JPG images

Table of Contents

1. Installation
2. Motivation
3. Example
4. Sample
5. Troubleshooting

Installation

The repository contains a zipped file of my Python package asciimage and should be installed via pip.
Instalation procedure:
pip install asciimage
pip install docx
pip install python-docx
#The docx and python-docx libraries must be installed

Motivation

The package is intended as a simple drawing tool that produces ASCII art.
The user will upload an image. The image has to be a jpg or png image. The image should have a nice contrast for proper output.
The package contains the function make_ascii_image() which produces ascii art
For the colored ASCII image function, the input images should not be very richly colored and the function works well for images of small size, up to dimensions 256X256.

Example

This is the way to run the module:

	from asciimage import *
	from PIL import Image #import the module
	image_path = r"input_image.jpg"
	file_path = r"output.txt" #'output.txt' is the destination where the ASCII art will be stored
	ascii_char = list(",.")
	height = 400 #intended height of output file
	width = 400 #intended width of output file
	art = asciimage(image_path,file_path,ascii_char,height,width) #optional: ascii_char,height,width
	art.make_ascii_image()

	#for colored ascii image
	from PIL import Image
	from docx import *
	from docx.shared import *
	image_path = r"input_image.jpg"
	file_path = r"output.doc" #'output.doc' is the destination where the ASCII art will be stored
	art = asciimage(image_path,file_path) #compulsory: image_path,file_path
	#this function outputs a doc file only
	art.make_colored_ascii(64)#produces 64X64 image; 

Sample

Input Image:

Output text file:

Colored ASCII Input Image:

Output doc file:

If you like the library, please consider giving it a star on Github :)

Troubleshooting

This is a common error:
If this happens, it is because of python-docx not being installed. In that case, please proceed with:
pip install python-docx
pip install docx