diff --git a/README.md b/README.md
index 82722ab..f5d74c4 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,16 @@
-See https://github.com/Anyon3/blackmate
+# BlackMate
+
+![Alt text](blackmate.png?raw=true "Title")
+
+## Blackmate
+
+Blackman is a generator for the tools list of BlackArch Linux OS, made for the wm Mate Desktop. The script fetch the latest tools and generate an new entry on the blackarch menu
+
+## How to 
+
+```
+git clone https://github.com/Anyon3/blackmate
+mv blackman /usr/share/
+cd /usr/share/ 
+sh blackman.sh
+```