diff --git a/apps.json b/apps.json
index e3b6a73fa..0622dfcae 100644
--- a/apps.json
+++ b/apps.json
@@ -3470,6 +3470,7 @@
   "version":"0.01",
   "description": "Choose people or things at random using Bangle.js.",
   "tags": "tool",
+  "readme": "README.md",
   "allow_emulator":true,
   "storage": [
     {"name":"choozi.app.js","url":"app.js"},
diff --git a/apps/choozi/README.md b/apps/choozi/README.md
new file mode 100644
index 000000000..f1e4255bc
--- /dev/null
+++ b/apps/choozi/README.md
@@ -0,0 +1,27 @@
+# Choozi
+
+Choose people or things at random using Bangle.js.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/4cqOLNM5ei8" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+## Usage
+
+You can use Choozi to pick a person to play first in a board game. With all
+the players seated in a circle, set the number of segments equal to the number
+of players, ensure that each person knows which colour represents them, and then
+choose a segment. After a short animation, the chosen segment will fill the screen.
+
+You can use Choozi to randomly select an element from any set with 2 to 13 members,
+as long as you can define a bijection between members of the set and coloured
+segments on the Bangle.js display.
+
+## Controls
+
+BTN1: increase the number of segments
+BTN2: choose a segment at random
+BTN3: decrease the number of segments
+
+## Creator
+
+James Stanley
+September 2021