diff --git a/projects/vango/README.md b/projects/vango/README.md
index 42e24a4..6e60d94 100644
--- a/projects/vango/README.md
+++ b/projects/vango/README.md
@@ -1,11 +1,9 @@
-VAnGo
-===========
+# VAnGo
 
 The VAnGo (Vanadium-Android-Go) android app allows running arbitrary Vanadium Go
 code in the android application.
 
-Running your Vanadium Go Code in Android
-----------------------------------------
+## Building Vanadium Go Code for Android
 
 1. Modify the [vangoFuncs] map to include your custom Go function, keyed by a unique
    string key.
@@ -20,11 +18,23 @@
 
 You may need to run `jiri goext distclean` for your changes to take effect.
 
-3. In Android Studio, where you have opened the VAnGo application,
+## Running using Android Studio
+
+1. In Android Studio, where you have opened the VAnGo application,
    run "Build >> Clean project" to remove any locally cached versions
    of the Vanadium android-lib.
 
-4. In Android Studio, run the application. It will display a text field. Inputting your unique
+2. In Android Studio, run the application. It will display a text field. Inputting your unique
    string key into the field and hitting "Run" will run your custom Go code.
 
+## Running using [`madb`]
+
+1. Set the `ANDROID_HOME` environment variable
+
+2. ```sh
+madb start
+madb exec logcat *:S vlog:*
+```
+
 [vangoFuncs]: https://vanadium.googlesource.com/release.go.x.jni/+/master/impl/google/services/vango/funcs.go
+[`madb`]: https://github.com/vanadium/madb