diff --git a/README.md b/README.md
index 76c05b4..9f1101b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
 # utility-freerdp
 
-Script template to handle connections limiting dependency to freerdp.
\ No newline at end of file
+Script template to handle connections limiting dependency to freerdp.
+
+The template handles if session is wayland or x11.
+
+## Usage
+
+Copy the prototype to your local bin folder and name it what ever makes sense to your usecase e.g. use a `nickname` and make sure it is executable.
+
+Make the file executable
+
+    chmod +x ~/.local/bin/nickname
+
+Adjust the properties at the top of the script - just below the header - to match your connection and save the file.
+
+
+Then you can execute from commandline
+
+    nickname
+
+If you want a shortcut - with an icon to click - create a desktop file **~/.local/share/applications/nickname.desktop** with content
+```
+[Desktop Entry]
+Name=nickname RDP
+Icon=network-server
+Comment=Connect to nickname RDP
+Exec="~/.local/bin/nickname"
+Version=1.0
+Type=Application
+Terminal=false
+StartupNotify=true
+```