Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Live preview of ditaa files in your browser
Branch: master


Ditaa is command-line utility written in Java, that can convert diagrams drawn using ascii art into proper bitmap graphics. Ditaa-live is a golang web server that show the generated images from ditaa. But the most important thing is that the image is automatically reloaded when the ditaa file is modified. It works by opening a websocket connection to the server that will monitor the file with inotify (Linux-only).

Note: ditaa-live only works in a browser that supports WebSocket, i.e. Chrome or Firefox.

How to use it?

Install ditaa

  • On Debian: apt-get install ditaa
  • On os X: brew install ditaa

Install golang-weekly (2012-02-07) and don't forget to set $GOROOT. And then, run these instructions:

go get
go get
go get
ditaa-live path/to/a/directory


♡2012 by Bruno Michel. Copying is an act of love. Please copy and share.

Released under the MIT license

Something went wrong with that request. Please try again.