This is a simple Python program that converst an image into ascii art.
I thank all people that use this for their project. I love to contribute to the community. However, please credit me by using the GitHub project link.
To use this program, you need python 3.6+ and all of the required packages installed.
To install the required packages, run: pip3 install -r requirements.txt
- Run
py main.py -image "PATH/TO/IMAGE" -output "OUTPUT FILENAME"
| Argument | Description |
|---|---|
| -image | path to input image |
| -output | output file name |
| --colored | enables colors |
| --char_per_pixel | creates an ascii char for every pixel |
| -font_size | change font size (default: 16) |
| -font_path | path to the font file (default file: consolas.ttf) |
| -characters | change the used characters (must be sorted from darkest to brightest) |
- Import the text-to-speech function with
from imageprocessor import AsciiImageProcessor. - Create an instance of
AsciiImageProcessor:processor = AsciiImageProcessor()in your code. - Get an image by running
image = processor.get_ascii_img("PATH/TO/YOUR/IMAGE") - Save the image
image.save("OUTPUT FILE NAME")
I provided an example script which shows how the ascii-image-converter could be used in a script.