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:
For custom Go installs
go install github.com/TheZoraiz/ascii-image-converter@latest
For physically installing the binaries, download the executables from here, and follow the steps with respect to your OS.
Extract Executables.zip 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 Executables.zip 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]
--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
, # Or ascii-image-converter [path to image] --dimensions ,
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