Skip to content
Live preview of ditaa files in your browser
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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.