diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8548ba6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# npcscan - WoW 1.12 addOn
+
+
+
+This addOn automatically scans for characters by name and alerts you upon finding one. Instead of the modern scanning methods which don't work for Vanilla it uses the API function *TargetByName* which was removed with TBC.
+
+The alert is visually and acoustically an exact copy of the famous addOn *_NPCScan* which first appeared during WotLK and in tribute to which this is named *npcscan*, though it also works for players.
+
+There are two commands:
+**/npcscan** lists the active scan targets
+**/npcscan name** adds/removes **name** to/from the scan targets
+When a target is detected it is removed and has to be readded to continue scanning for it.