ascii

A standalone executable that converts a standard image into viable ASCII art.

Syntax: ./ascii <--in> photo.png [--out] out.txt [--scale] 0.5 [--stretch] 0.5 [--print] [--close-colour] [--true-colour]

Often, you may require a very low scale factor (>0.1), particularly for larger images.

Arguments

Required:

• --in <image.png> - Specifies the input image. Can be png or jpg/jpeg.

Optional:

• --out <out.txt> - Specifies the output file. If none is provided, this is disabled.
• --scale <number> - Scales the result, making it more viable to be printed in a console. Must be above 0 (e.g. 0.5 would halve the size of the result). Defaults to 0.5.
• --stretch <integer> - Stretches the result horizontally. This is useful for larger images. Must be above 0. Defaults to 1.
• --print - Prints the result to the console once finished.
• --pretty - When --print is passed, output is printed layer-by-layer.
• --close-colour - Colours the output by rounding RGB values to the closest available ANSI codes.
• --true-colour - Colours the output using exact RGB-ANSI codes. Not supported on most consoles.

GIFs

Download and use the gif.py script to generate an ASCII gif! Syntax: python gif.py <file.gif> <scale> [frames].

You can use the view.py script to view the generated ASCII gif: python view.py <directory>.

Example