diff --git a/README.md b/README.md
index 4d9bdda..969ff44 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
+Very silly terminal-based crossword solver. It can play .puz files from a variety of sources, including [Crosshare](https://crosshare.org).
+
+- Requirements: [Go](https://go.dev)
+- Build: `make`
+- Usage: `./bin/crossword <file>.puz`
+
+![demo](demo.gif)
+
+---
+
 todo
 
 - correctly calculate uiHeight with multi-line clues
diff --git a/demo.gif b/demo.gif
new file mode 100644
index 0000000..c010af9
Binary files /dev/null and b/demo.gif differ