ascii-image-converter is a command-line tool that converts images into ascii art and prints them out onto the console. It is cross-platform so both Windows and Linux distributions are supported

Image formats currently supported:

  • PNG
  • WEBP
  • BMP

Example (Source):






For custom Go installs

go install[email protected]

For physically installing the binaries, download the executables from here, and follow the steps with respect to your OS.


Extract and open the "Linux" directory.

Now, open a terminal in the same directory and execute this command:

sudo cp ascii-image-converter /usr/local/bin/

Now you can use ascii-image-converter in the terminal. Execute "ascii-image-converter -h" for more details.


You will need to set an Environment Variable to the folder the ascii-image-converter.exe executable is placed in to be able to use it in the command prompt. Follow the instructions in case of confusion:

Extract and open the "Windows" folder. Copy the path to folder from the top of the file explorer.

  • In Search, search for and then select: System (Control Panel)
  • Click the Advanced System settings link.
  • Click Environment Variables. In the section User Variables find the Path environment variable and select it. Click "Edit".
  • In the Edit Environment Variable window, click "New" and then paste the path of the folder that you copied initially.
  • Afterwards, you can use it anywhere by typing "ascii-image-converter" in command prompt. Note: Make sure you restart the command prompt.


Note: Decrease font size or zoom out of terminal for maximum quality ascii art

To convert an image into ascii format, the usage is as follows:

ascii-image-converter [path to image]


ascii-image-converter myImage.jpeg


--complex OR -c

Print the image with a wider array of ascii characters. Sometimes improves accuracy.

ascii-image-converter [path to image] -c
# Or
ascii-image-converter [path to image] --complex

--dimensions OR -d

Set the width and height of the printed ascii image in character lengths.

ascii-image-converter [path to image] -d <width>,<height>
# Or
ascii-image-converter [path to image] --dimensions <width>,<height>


ascii-image-converter [path to image] -d 100,30

--save OR -S

Save the image ascii art in a file ascii-image.txt in the same directory

ascii-image-converter [path to image] --save
# Or
ascii-image-converter [path to image] -S

You can combine commands as well

ascii-image-converter [path to image] -Scd 100,30