Convert images to binary ANSI art
Pull request Compare This branch is 4 commits behind jhchen:master.
Latest commit 671b534 Jun 17, 2013 @jhchen jhchen update readme
Failed to load latest commit information.
examples add example input and ouput Jun 16, 2013
.gitignore ignore build output Jun 16, 2013
LICENSE add MIT license Jun 16, 2013 update readme Jun 17, 2013
ansize.go assure go compiler we always return a value Jun 17, 2013


Converts an image to binary ANSI art like so:


Check out the examples folder for some image samples and their corresponding output. Ex.

cat examples/pikachu.ansi

I optimized for images with dark backgrounds and used 0's and 1's for the character set but it's pretty easy to customize the code to convert to your liking! The basic strategy of conversion is very simple:

  1. Shrink image to desired size
  2. For each pixel, find the corresponding color in ANSI's limited color palette
  3. Set the foreground to that color
  4. Print a random 0 or 1


  1. Install go
  2. Set your $GOPATH
  3. Install
  4. Build ansize

On a Mac with Homebrew the commands are

brew install go
mkdir /usr/local/lib/go
export GOPATH=/usr/local/lib/go
go get
go build ansize.go


./ansize <image> <output> [width]