diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..a51284d25e2ae1855c32a2a03c9b5d9e374c55cc
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,18 @@
+# Avocent Console Tool
+
+Python utility to make the Avocent IP KVM Java client work on Mac.
+Tested on Avocent AV3216
+
+## Prerequisites
+
+- up to date Homebrew
+- Java 8 with java in path
+- Python 3
+
+## How to use
+
+1. Run `python3 start-console.py`
+2. Drag the jnlp file generated by your IPKVM to the terminal window
+3. Enter your sudo password, or use TouchID for sudo verification when asked
+4. Use Java console as normal
+