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.
--in <image.png>
- Specifies the input image. Can bepng
orjpg/jpeg
.
--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 above0
(e.g.0.5
would halve the size of the result). Defaults to0.5
.--stretch <integer>
- Stretches the result horizontally. This is useful for larger images. Must be above0
. Defaults to1
.--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.
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>
.