diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8419068
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# HexArt
+
+An hex-based paletted image ~~editor~~ creator.
+
+Keys:
+
+- up/down/left/right move cursor
+- i/k/j/l move cursor
+- z decrement
+- x increment
+- shift+z step decrement
+- shift+x step increment
+- a propagating increment
+- s propagating decrement [NYI]
+- v "visual" mode [partially implemented - not compatible with propagating modes]
+- w save
+- esc exit (double esc if modified)