diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..ef8d272
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+# What is this?
+
+A collection of shell scripts that I use with dmenu to make my life easier.
+
+Right now most of them are filled with basisms but thats slowly changing overtime.
+
+# I have a cool script too can I contribute it here?
+
+Of course! Submit a merge request or just email the file/file to my email `alejandros714@protonmail.com`.