diff --git a/README.md b/README.md
new file mode 100644
index 0000000..775c8ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+README
+======
+
+Installing
+----------
+
+Clone repo:
+
+```sh
+ $ git clone https://git.rzen.dev/rzen/terminal-joke-dashboard.git
+```
+
+Run:
+
+```sh
+ $ ./run.sh
+```
+
+To exit simply press `Control-C`.
+
+Customizing
+-----------
+
+Tweak `dash.sh`.
\ No newline at end of file