diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e0ca174
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# HRM
+
+An example heart rate monitor app for Android and MacOS using [git.wow.st/gmp/ble](https://git.wow.st/gmp/ble) and [Gio](https://gioui.org).
+
+The MacOS implementation uses a Core Bluetooth binding created by
+[NSWrap](https://git.wow.st/gmp/nswrap). On Android, Martijn van Welie's
+[Blessed](https://github.com/weliem/blessed-android) library is used to
+simplify access to the Bluetooth Low-Energy hardware.
+
+## MacOS:
+
+```
+git clone https://git.wow.st/gmp/hrm
+cd hrm/hrm
+go build
+./hrm
+```
+
+## Android:
+
+The `gogio` command from `gioui.org/cmd/gogio` must be installed to build
+an Android APK.
+
+```
+git clone https://git.wow.st/gmp/hrm
+cd hrm/hrm
+gogio -target android .
+adb install -r hrm.apk
+```
+
+The compiled Java code for the Android implementation is pre-packaged in
+jar files. If you want to, you can re-compile these dependencies by running
+`go generate` from the `depjars` directory. You will need to have `gradle`,
+an Android SDK, and who knows what else installed on your machine.
diff --git a/hrm/README.md b/hrm/README.md
deleted file mode 100644
index 8efaaaa..0000000
--- a/hrm/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# HRM
-
-An example heart rate monitor app for Android and MacOS using [git.wow.st/gmp/ble](https://git.wow.st/gmp/ble) and [Gio](https://gioui.org).
-
-## MacOS:
-
-```
-go get git.wow.st/gmp/hrm
-cd ~/go/src/git.wow.st/gmp/hrm
-go build
-./hrm
-```
-
-## Android:
-
-The `gogio` command from `gioui.org/cmd/gogio` must be installed to build
-an Android APK.
-
-```
-go get git.wow.st/gmp/hrm
-cd ~/go/src/git.wow.st/gmp/hrm
-gogio -target android .
-adb install -r hrm.apk
-```