diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0221f58
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+Some asterisk hacks for radios.
+
+## Ring monitoring
+
+We need to turn on lights when phones are supposed to ring, or when they are calling. This AMI-based  Python
+application will extract the relevant bits.
+
+## Transfer back
+
+We want to send people on air when the DJ presses `#9`.
+The DJ will then be put with MusicOnHold.
+When they press `9`, they can talk again with the person that was on air.
+If any of them hangs up, the call will end for the other one.
+
+