command module
v0.0.0-...-1177451 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Feb 20, 2015 License: MIT Imports: 12 Imported by: 0



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


go get


ansize <image> <output> [width]


  1. Install go
  2. Set your $GOPATH
  3. Install
  4. Clone ansize
  5. 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
git clone
go build ansize.go


The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL