~/theoboursy.fr/img2ascii

CLI tool written in Go

img2ascii

A small Go CLI for turning images into clean ASCII art. Drop in a picture, tune the output width, and get a copy-friendly render right in your terminal.

preview
╭─  ❯ gopher@MacBook-Pro ❯ ~
╰─ $ img2ascii ~/Pictures/gopher/beautiful_gopher.png
                               .:-=+**##%%%%%%##*+=-:.
                          .=*#%@@%%##**++++++++**#%%@@%#+:  ....
                 :=**#*=+%@@#*+=-----=============---=+*%@@%@@@@%#=.
              :*@@%#**#%@*=---==++**##******#*++====--==:-+==---=#@@*.
             +@@*-:-==- .-=--=====---+******=:-=**#**=--*+: -**+=::%@#
            -@@+.+*+==:-*=:*%@@@@@@%*::****.-%@@@@@@@@%+.*#+: .+**::%@+
            #%% +#=   +#-.%#+*%%%%%@@@:-**:-%=:=%%%%%%%@=.***- +*#= %%*
            +@%::**: ***.*=  .=%%%%%%%*.** *=  .=%%%%%%@* ***#::*-.*@@:
            .#@%=:- +***:-#:.=*%%%%@@@:-##=.#+=*%%%@@@@#.-***** :+%@%-
              =#@%-.*****:-#%@@@@@@%*--+=-=::+#%%@%%%*=:=******-:@@*
               *%%.=******=--=++++=----     .::-------=********+ #%#
               #%# +********++====++:=++===+*+--**************** +%@.
               %%# ****************=.##*++++##+.+***************.=@%-
               %@# *****************+::++ +*.--+****************::@%=
               %@# +****************#= %* #% =#*****************-:@@+
               #@% +******************=:-=---*******************-.@@+
               *%%.=********************************************-.@%+
               =%@::********************************************=.%@+
               :%%=.********************************************=.%%+
             .=*@@+.********************************************=.@@%+-
           :*@@#++-.********************************************= ==*%@%=
          .%@*:-+*= ********************************************+ **=.+@@-
          -@%+ -*+:.********************************************+ -+- =%@=
           +@@*==*=.********************************************* =++#@@+
            -*%@@@-:*********************************************.+@@#+:
               +%%:-*********************************************.=%%:
               *@%.=*********************************************:=@%-
               #%% +*********************************************:=@%-
               #@# +*********************************************.=@%:
               #@# +********************************************* +%%.
               #%% +********************************************+ #%#
               +%@.-********************************************-:@@+
               :@%+.******************************************** *%%.
                #@%.=#****************************************#.-@@+
                :%@# =#***************************************::%@#
                 -%@#.-*************************************+:-%%*
                  -%@@-.=+********************************=: =@@%.
                 :#@%=-==--=+*************************+=-:=+*--%@#.
                 %@#.:-%%*: :---==+++*********+++==----+=:=#*-.:%@+
                 %@#. -+--*%@@%#*+==-----------==+*#%@@@@%=:=..+@@-
                 :#@@*++#@@*-:=*#%%@@@@@@@@@@@@@%%#*+-: =#@@#%@@#-
                   :+#%#*=.         ..:::::::..           :=++=:

Installation

The install scripts automatically download the matching binary from the latest GitHub release.

macOS / Linux curl -fsSL https://raw.githubusercontent.com/Boursyt/img2ascii/refs/heads/main/install/install.sh | bash
Windows PowerShell $script = Join-Path $env:TEMP "install-img2ascii.ps1"; curl.exe -fsSL https://raw.githubusercontent.com/Boursyt/img2ascii/refs/heads/main/install/install.ps1 -o $script; powershell -ExecutionPolicy Bypass -NoProfile -File $script