diff --git a/README.md b/README.md
new file mode 100644
index 0000000..02c1a8e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,80 @@
+# SpaceDevices
+
+Gets the current active mac/IP combination from our wifi access points via mqtt (sessionTopic). Has a global database (masterFile) 
+and a user customizable database (userFile). The last one is changeable via a web interface. Any client can only change the entry
+for its current mac address. 
+
+As result an json string is sent via mqtt (devicesTopic), e.g.:
+````json
+{  
+  "people":[  
+    {  
+      "name":"Hans",
+      "devices":[  
+        {  
+          "name":"Handy",
+          "location":"Space"
+        },
+        {  
+          "name":"Thinkpad",
+          "location":"Space"
+        }
+      ]
+    },
+    {  
+      "name":"Jon",
+      "devices":[  
+        {  
+          "name":"Handy",
+          "location":"Space"
+        },
+        {  
+          "name":"Mac",
+          "location":"Space"
+        }
+      ]
+    }
+  ],
+  "peopleCount":8,
+  "deviceCount":38,
+  "unknownDevicesCount":18
+}
+```` 
+
+The web interface:
+
+![web interface](extras/screenshot.jpg)
+
+
+# Dependencies
+
+Install all dependencies with
+```
+dep ensure
+```
+
+
+# Build
+
+```
+go build cmd/spaceDevices.go
+# or use the script 
+./do.sh build-linux
+```
+
+
+# Config
+
+Copy `config.example.toml` to `config.toml` and change as you like. 
+
+
+# Run
+
+```
+./spaceDevices
+# or for production mode
+GIN_MODE=release ./spaceDevices 
+```
+
+You can also use the systemd service file `extras/spaceDevicesGo.service`
+
diff --git a/extras/screenshot.jpg b/extras/screenshot.jpg
new file mode 100644
index 0000000..1f21083
Binary files /dev/null and b/extras/screenshot.jpg differ