sensorflo edited this page Jan 29, 2014 · 3 revisions

git-draw draws nearly the full content of a tiny git repository as a graph. For example after the following few git commands

git init
echo 'hello world' > greeting.txt
git add greeting.txt
git commit -m 'initial commit'
git tag R1 -m R1
echo 'bye bye' > parting.txt
git add parting.txt
git commit -m 'added parting'
echo 'welcome' > greeting.txt
git add greeting.txt

git-draw will display the following image


The text provided here is a copy of the documentation the git-draw script contains.

  git-draw - draws nearly the full content of a tiny git repository as a graph

  git-draw [OPTION]...

  You don't need all of these if you use git-draw with certain options.

  - graphviz (
  - imagemagick (

  If you have apt you can install these with:

    sudo apt-get install graphviz imagemagick

  git-draw is composed of three main steps, where the 2nd and 3rd are just for
  convenience and are not part of git-draw's core responsibility.

  1) A .dot file describing the repository's content as a graph is created.
  2) dot (see graphviz) is called to produce an image out of that .dot file.
  3) display (see imagemagick) is called to display that image.

  The current working directory must be at the root of the working tree of
  your project, i.e. the directory which contains the .git directory.

  The intention is to help learning Git's basic concepts (references, Git
  objects, SHA-1 checksum over content as id). Virtually all information
  concerning Git's basic concepts is contained in the drawing. Thus git-draw
  is aimed at tiny toy Git repositories and at users with an engineer
  background, i.e. users which are not scared off by terms like checksum,
  references aka pointers and graphs.

  -p, --print-only
    Only prints the .dot file to STDOUT. Mutually exclusive with --image-only.

  -i, --image-only
    Only generates an image of the graph, and a .dot file beforehand. Mutually
    exclusive with --print-only.

  Written by Florian Kaufmann <>

  Florian Kaufmann 2014. License GPLv3+: GNU GPL version 3 or later
  <>. This is free software: you are free to
  change and redistribute it. There is NO WARRANTY, to the extent permitted by
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.