diff --git a/README.md b/README.md
index 9a03213..224a528 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,9 @@
-### [Demo](https://victorwesterlund.github.io/crtjs-test/)
+# Cathode Ray Tube (JS)
+
+Simulating the fundimentals of a CRT display using pure JS (for fun). 
+
+Raster patterns are drawn onto a simulated phosphor display from virtual video tapes.
+
+## Try it out
+**Warning!** This thing might **really** bring your browser down on its knees. Setting the framerate too high might even break it completely (make it crash).
+### [Live demo](https://victorwesterlund.github.io/crtjs-test/)