diff --git a/README.md b/README.md
new file mode 100644
index 0000000..84a82e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# card-device-firmware
+
+Firmware and supporting libraries for a custom hardware device.
+Also see the [hardware repository](https://git.shylie.info/shylie/card-device-hardware),
+and the accompanying [host-side software repository](https://git.shylie.info/shylie/mtgcard-upload).
+
+Here are some photos:
+
+<img src="docs/images/pcb.png" alt="pcb image" width="200"/>
+<img src="docs/images/card.jpg" alt="card displayed on device" width="200"/>
+<br/>
+<video width="240" controls>
+  <source src="docs/images/menus.mp4" type="video/mp4">
+</video>
+<video width="240" controls>
+  <source src="docs/images/pong.mp4" type="video/mp4">
+</video>
+
diff --git a/docs/images/card.jpg b/docs/images/card.jpg
new file mode 100644
index 0000000..ccde3ac
Binary files /dev/null and b/docs/images/card.jpg differ
diff --git a/docs/images/menus.mp4 b/docs/images/menus.mp4
new file mode 100644
index 0000000..1d65ea5
Binary files /dev/null and b/docs/images/menus.mp4 differ
diff --git a/docs/images/pcb.png b/docs/images/pcb.png
new file mode 100644
index 0000000..4d158ab
Binary files /dev/null and b/docs/images/pcb.png differ
diff --git a/docs/images/pong.mp4 b/docs/images/pong.mp4
new file mode 100644
index 0000000..8193356
Binary files /dev/null and b/docs/images/pong.mp4 differ