Skip to content
A document version of my "Vipassana for Hackers" talk
Branch: master
Clone or download

Vipassana for Hackers

A document version of the talk "Vipassana for Hackers" by Steven Deobald (GitHub, Twitter).

Generate the Papers

On a Mac, install MacTeX, LaTeXML, and Calibre as instructed below. (Linux should be similar.) Clone and make:

$ git clone
$ cd vipassana-for-hackers
$ make clean && make

PDF Generation

On a Mac, the easiest option is installing MacTeX. It's also possible to install only the required packages but that process has been abandoned for this project. Once you have MacTeX installed, clone the repo and run each paper's build script:

$ git clone
$ cd vipassana-for-hackers/paper-one
$ ./

You will see many warnings but you shouldn't see any errors.

EPUB Generation

The epub version of the LaTeX was generated with the following procedure on macOS 10.10.5 and 10.13.4. Each script builds an epub for one paper at a time.

$ git clone
$ brew install latexml
$ brew install caskroom/cask/calibre
$ cd vipassana-for-hackers/paper-one
$ ./


  • Create output directory
  • Script epub generation
  • Add a Makefile
  • Switch Paper One 70-minute (children's) Anapana to 20-minute (adult)
  • Test epub gen, add to makefile, add full build target
  • Transcribe Paper Three and Paper Four notes
  • Invert brain diagram colours for Paper One
You can’t perform that action at this time.