/image-to-ascii

Primary LanguageGo

Image to ASCII

This is a simple application that converts an image to ASCII art.

supported formats

  • gif

future support

  • jpg
  • png
  • bmp

How to use

$ go run main.go -w=25 -h=25 -i=localfile.gif

or

$ go run main.go -w 25 -h 25 -i localfile.gif

or

$ go run main.go -c -w=75 -h=100 -i=https://upload.wikimedia.org/wikipedia/commons/5/5a/Rotating_Tux.gif

how to build

$ go build -o image2ascii main.go

Note

  • The image will be resized to the width and height specified in the flags
  • The image will be converted to grayscale
  • Remember to do zoom out in your terminal to see the image correctly

Flags

Flag Description Default Needed
-w width of the image 25 No
-h height of the image 25 No
-i input source image , it can be a localfile or external url empty Yes
-c active color mode false No

Recomended terminals

  • Kitty - this terminal is the best in the test for the moment
  • KDE Konsole