Created: 2011-07-10 22:28
Updated: 2018-04-21 13:09



v0.3.6, 2014-10-10


$ ./asciidia.php -h
$ ./asciidia.php -v
$ ./asciidia.php -t ... -h
$ ./asciidia.php -t ... -i ... -o ... [-c ...] [-s ...]


Asciidia generates bitmap or vector files from simple ASCII diagrams. In that it is similar to programs like ditaa. It's build on top of a plugin architecture to make it easy to enhance it with additional diagram or drawing plugins. Currently available plugin types are:

  • simple ASCII diagrams, currently not as many features as what ditaa provides, though
  • directory tree diagrams
  • syntax-diagrams (railroad diagrams) by specifying an EBNF
  • identicon generator

Asciidia can directly generate SVG and ImageMagick MVG files, it can make use of ImageMagick "convert" utility to render to many other image formats, too.


-h  show information about command-line arguments. provide a diagram type
    with '-t' to show help about the plugin

-v  show version information

-t  plugin type to load. available plugins are:


-i  input filename or '-' for STDIN

-o  output filename or '-' for STDOUT

-c  defines the widht/height of each cell / character on the canvas in 
    pixel. Notation is ...x... (width x height) or ... (width x width).

-s  scales image. notation is ...x... (width x height) whereas ... is a 
    number to scale to. if width or height are ommited, image will be 
    scaled by keeping aspect ratio. 

It's possible to specify an output format by prefixing the output filename in the form


For example:

./asciidia.php -t ebnf -i rules.ebnf -o svg:diagram.svg


  • php 5.3
  • imagemagick is only required, if output format is not 'svg'


The following embedded image was created on Mac OS X using asciidia and inkscape with the command:

/Applications/ \
    -z -e test/ebnf.png -w 500 \
    <(asciidia -t ebnf -i test/ebnf.txt -o svg:-)




Copyright (c) by Harald Lapp <>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <>.


I would like to thank the following person(s) for improvments and bug fixing:

  • Liviu Cristian Mirea-Ghiban,

    identicon plugin:

    1. The sprites were being drawn with an additional 1px per width and height and had bleeding edges in the final image.
    2. The rotations didn't completely match the ones in the original PHP Identicon script.
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more