diff --git a/README.md b/README.md
new file mode 100644
index 0000000..093cadf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# virtual-media-keys
+
+Some [AutoHotkey](https://autohotkey.com/) scripts meant for people with
+keyboards without media keys. These scripts intercept some hotkeys and
+send media keys in their place.
+
+There are currently two flavors: arrow keys and navigation keys. The first
+one binds to the arrow keys, while the second one binds to navigation
+keys.
+
+| Command | Arrows | Navigation |
+|---------|--------|------------|
+| Play/pause | Ctrl + Alt + ↑
Ctrl + Alt + ↓ | Ctrl + Alt + PgUp
Ctrl + Alt + PgDn |
+| Previous | Ctrl + Alt + ← | Ctrl + Alt + Home |
+| Next | Ctrl + Alt + → | Ctrl + Alt + End |
+
+## Running / compiling
+
+The scripts can be executed directly using
+[AutoHotkey](https://autohotkey.com/). It also allows for compiling the
+scripts. Binary files attached to releases have been modified to use the
+complete icon set.