goscii

README

GOSCII

A dead simple from image to ASCII art generator written in Go.

                                 @@@@@@@@%%###**+++++++****###%%@@@@@@@                             
                          @@@@%#*+=--:::::::::::::::::::::::::::::::-=+*#%@@@                       
                     @@@%*=-:::::::::::::::::::::::::::::::::::::::::::::::-=*%@@@  @@@@@@@@@@      
     @@@%%##%%@@@@@@#=-::::-===+=+==--:::::::::::::::::::::=+=====--=====+=:::::-*%%+-::::::-=*@@@  
  @@#+-::::::::=#*-:::-=+==-:..   ..:-==+=:::::::::::::-++=:.   :=+=-.   .:=+-:::::-*+-:::::::::=%@ 
 @#-:::::--::=*=::::=+=.     .=#%%#+:   .-++::::::::::++.     .#@@@@@@-     .=*-:::::-*@@@#-::::::#@
@+::::-%@@@@#=::::-*-        #@@@@@@@:     :*-::::::-#:       -@@@%@@@*       :#-::::::-#@@#::::::-@
@-::::*@@@@*-:::::#:         +@@#=%@%:      :#::::::#:         -#%=*%+.        =+::::::::+%-::::::=@
@*:::::=*@=::::::-*           :=+=+-.        *-:::::%                          :#:::::::::+*:::::+@@
 @%=::::#=:::::::-#                          #-:::::*-                         +=::::::::::*+-+#@@  
   @@%***:::::::::*=                        =+::::::-*-                      .++:::::::::::-%@@     
      @%:::::::::::++.                    :+=:::--==--=+-.                 :=+-:::::::::::::=@      
      @+::::::::::::-+=-.             .:=++::+%@@@@@@@%*=+==-:.      .:-==+=-::::::::::::::::%@     
     @@::::::::::::::::-====-------=====::-=#@@@@@@@@@@@#=-:-==========-:::::::::::::::::::::=@     
     @#:::::::::::::::::::::::::::::::::+*+--+*#%%%##*+=-=+*+-::::::::::::::::::::::::::::::::@@    
     @*::::::::::::::::::::::::::::::::=#-------------------=#-:::::::::::::::::::::::::::::::#@    
     @+::::::::::::::::::::::::::::::::-#=----==++*+++=-----=#-:::::::::::::::::::::::::::::::*@    
     @+:::::::::::::::::::::::::::::::::-++#+=-:.-%  .:**+++=:::::::::::::::::::::::::::::::::=@    
     @*::::::::::::::::::::::::::::::::::::#:    =*    -*:::::::::::::::::::::::::::::::::::::=@    
     @*::::::::::::::::::::::::::::::::::::=*.  .*#.   -*:::::::::::::::::::::::::::::::::::::-@    
     @%:::::::::::::::::::::::::::::::::::::-+==+--+==++-:::::::::::::::::::::::::::::::::::::-@    
 

Documentation

Obviously you will need Golang installed on your machine.

go get ./...
go run main.go [-i input] [-o output] [-d int] 

Flags

-i is to indicate the path to the input image (png or jpeg).

-o is to indicate the path to the future txt file containing the ASCII.

-d (optional) is to indicate the int by which the height and the width of the image will be divided (strictly positive, default is 1).

License

Provided under the MIT License.