diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6397da1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# UEFI Conway's Game of Life
+
+Conway's GOL in uefi-rs.
+
+## Run in QEMU
+
+Install the firmware files:
+
+Nix:
+
+```
+nix build nixpkgs#OVMF
+```
+
+Debian/Ubuntu:
+
+```
+sudo apt-get install qemu ovmf
+```
+
+Fedora:
+
+```
+sudo dnf install qemu-kvm edk2-ovmf
+```
+
+Then copy the firmware files to the project directory.
+
+Then run
+
+```
+./run.sh
+```