diff --git a/README.md b/README.md
index 92477d3..c5ec378 100644
--- a/README.md
+++ b/README.md
@@ -77,5 +77,22 @@ send windows to the background and ingore them.
 **[wms_screensaver.sh]**
 experimental scripts that keps windows in a loop of random movements.
 
+
+**SETUP STEPS**
+1 - download, compile and install wmutils/core and wmutils/opt.
+
+2 - clone this repo and put at least the main scripts in some executable path.
+
+3 - install a daemon for keyboard events, I have used sxhkd. Copy your configuration file, sxhkdrc, from wms/config to .config/sxhkd/.
+
+4 - copy the wms variables file, wms_var, contained in wms/config to .config/wms/.
+
+5 - add the following lines in .xinitrc or sxrc:
+  sxhkd &
+  exec wms_voyeur.sh
+
+!! In the case of using a Display Manager, copy the wms.desktop file contained in wms/config to /usr/share/xsessions and add the file wms.sh to the executable path.
+
+
 **This spawn doesn't have mouse support**
 **Sorry for the verbosity of the comments, the idea is to explain each script in general terms so that it can be easier to hack them**
\ No newline at end of file
diff --git a/art/wms.ascii b/art/wms.ascii
index a8d74a5..2a8b8e4 100644
--- a/art/wms.ascii
+++ b/art/wms.ascii
@@ -1,8 +1,25 @@
-━━━━━━━━━━━━━━
-━━━━━━━━━━━━━━
-┏┓┏┓┏┓┏┓┏┓┏━━┓
-┃┗┛┗┛┃┃┗┛┃┃━━┫
-┗┓┏┓┏┛┃┃┃┃┣━━┃
-━┗┛┗┛━┗┻┻┛┗━━┛
-━━━━━━━━━━━━━━
-━━━━━━━━━━━━━━
+
+┌─────────────────────────────────────────┐
+│               ..:::/::-.                │
+│             `-:::-::-::::`              │
+│            `:::-::::-:::--              │
+│            .:::::::::://-/.             │
+│            .::::::::-::::/.             │
+│             :`  `.//-`  .:              │
+│             :-----:--.---:              │
+│      `..`   `--::::::::--.   ```        │
+│      -:::-`    .:-::::-    `-:::.       │
+│     `:::::::-.`  ````` ..-:::::/:       │
+│      ``` ..--::-:....-::::..````        │
+│              `.::-::::--.               │
+│      `--.--::::-.`  `.-::/:-...-`       │
+│      .::::..`            ``-::::.       │
+│      .::`                    .::-       │
+│      `.`                      ...       │
+│  .____                           ____.  │
+│  |   _| __  _  _______   ______ |_   |  │
+│  |  |   \ \/ \/ /     \ /  ___/   |  |  │
+│  |  |    \     /  Y Y  \\___ \    |  |  │
+│  |  |_    \/\_/|__|_|  /____  >  _|  |  │
+│  |____|              \/     \/  |____|  │
+└─────────────────────────────────────────┘
diff --git a/config/sxhkdrc_example b/config/sxhkdrc
similarity index 100%
rename from config/sxhkdrc_example
rename to config/sxhkdrc
diff --git a/config/wms.desktop b/config/wms.desktop
new file mode 100644
index 0000000..2f66255
--- /dev/null
+++ b/config/wms.desktop
@@ -0,0 +1,7 @@
+[Desktop Entry]
+Name=wms
+Comment=Window Manipulation Shellscripts
+Type=Application
+Terminal=False
+Exec=<wms.sh
+TryExec=wms.sh
diff --git a/config/wms_names_example b/config/wms_names
similarity index 100%
rename from config/wms_names_example
rename to config/wms_names
diff --git a/config/wms_var_example b/config/wms_var
similarity index 100%
rename from config/wms_var_example
rename to config/wms_var
diff --git a/config/xinitrc_example b/config/xninitrc
similarity index 100%
rename from config/xinitrc_example
rename to config/xninitrc
diff --git a/opt/wms.sh b/opt/wms.sh
new file mode 100644
index 0000000..91995ab
--- /dev/null
+++ b/opt/wms.sh
@@ -0,0 +1,8 @@
+#!/bin/sh
+
+# This script summarizes the content of .xinitrc and can be used in case of building a minimal environment from a Display Manager.
+# wms.sh by @root_informatica.
+
+sxhkd &
+
+exec wms_voyeur.sh
\ No newline at end of file
diff --git a/opt/wms_backgroundize.sh b/opt/wms_backgroundize.sh
index 1e5a1af..426a4e2 100755
--- a/opt/wms_backgroundize.sh
+++ b/opt/wms_backgroundize.sh
@@ -1,7 +1,8 @@
 #!/bin/sh
 
 ## send windows to desktop background ##
-## it depends of wms_mainrole.sh ##
+## it depends of wms_focuser.sh ##
+# wms_backgroundize.sh by @root_informatica.
 
 . /tmp/wms_var
 
@@ -34,7 +35,7 @@ background() {
     # change border color to BC.
     chwb -c $BC $FW
     # focus prev window. 
-    wms_mainrole.sh -p
+    wms_focuser.sh -p
 }
 
 # restore windows from background
@@ -48,7 +49,7 @@ restore() {
     # delete atom.
     atomx -d WM_IGN $BID
     # focus it.
-    wms_mainrole.sh $BID
+    wms_focuser.sh $BID
 }
 
 if [ -n "$BID" ]; then
diff --git a/opt/wms_batlarm.sh b/opt/wms_batlarm.sh
index 1093cf9..db80083 100755
--- a/opt/wms_batlarm.sh
+++ b/opt/wms_batlarm.sh
@@ -2,6 +2,7 @@
 
 ## alternating window border colors depending on battery charge ##
 ## this script depends on power.sh which is in the /others repo ##
+# wms_batlarm.sh by @root_informatica.
 
 . /tmp/wms_var 
 
diff --git a/opt/wms_clearer.sh b/opt/wms_clearer.sh
index b8df273..c1fb3e3 100755
--- a/opt/wms_clearer.sh
+++ b/opt/wms_clearer.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## clean screen ##
+# wms_clearer.sh by @root_informatica.
 
 . /tmp/wms_var
 
diff --git a/opt/wms_jumper.sh b/opt/wms_jumper.sh
index 86042b6..a5331d7 100755
--- a/opt/wms_jumper.sh
+++ b/opt/wms_jumper.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## switch between windows ##
+# wms_jumper.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var
 
diff --git a/opt/wms_layout.sh b/opt/wms_layout.sh
index b80073f..c46801a 100755
--- a/opt/wms_layout.sh
+++ b/opt/wms_layout.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## some layouts to order the windows ##
+# wms_layout.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var
 
diff --git a/opt/wms_mimic.sh b/opt/wms_mimic.sh
index 03c3b92..4900120 100755
--- a/opt/wms_mimic.sh
+++ b/opt/wms_mimic.sh
@@ -1,5 +1,8 @@
 #!/bin/sh
 
+## extract colors from the desktop content by writing them to wms_var so that they are used by wms ##
+# wms_mimic.sh by @root_informatica.
+
 # temp image target.
 TMPIMG="/tmp/mimic.png"
 # temp extracted colors file.
diff --git a/opt/wms_screensaver.sh b/opt/wms_screensaver.sh
index 23732fd..92fd721 100755
--- a/opt/wms_screensaver.sh
+++ b/opt/wms_screensaver.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
-## use the windows on the desktop as screensavers by moving them randomly
+## use the windows on the desktop as screensavers by moving them randomly ##
+# wms_screensaver.sh by @root_informatica.
 
 . /tmp/wms_var 
 
diff --git a/opt/wms_shepperd.sh b/opt/wms_shepperd.sh
index 24ea29c..0b78982 100755
--- a/opt/wms_shepperd.sh
+++ b/opt/wms_shepperd.sh
@@ -1,7 +1,7 @@
 #!/bin/sh
 
 ## sort windows by herds/flock ##
-
+# wms_shepperd.sh by @root_informatica.
 . /tmp/wms_var
 
 FLAG=$1
diff --git a/opt/wms_termrename.sh b/opt/wms_termrename.sh
index 0131a43..be56bdc 100755
--- a/opt/wms_termrename.sh
+++ b/opt/wms_termrename.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## rename terminals ##
+# wms_termrename.sh by @root_informatica.
 
 . /tmp/wms_var
 
diff --git a/opt/wms_toggle.sh b/opt/wms_toggle.sh
new file mode 100755
index 0000000..e7a0b97
--- /dev/null
+++ b/opt/wms_toggle.sh
@@ -0,0 +1,34 @@
+#!/bin/sh
+
+## toggle visivility of windows ##
+# wms_toggle.sh by @root_informatica.
+
+FLAG=$1
+FW=$(pfw)
+
+unmap() {
+    atomx WM_MAP="$FW" $FW
+    mapw -u $FW
+}
+
+toggle() {
+    for wid in $(lsw); do
+	     atomx WM_MAP="$wid" $wid
+	     done
+    mapw -t $(atomx WM_MAP $(lsw -a))
+}
+
+case $FLAG in
+    -m)
+	unmap
+	;;
+    -t)
+	toggle
+	;;
+    *)
+	usage
+	;;
+esac
+
+    
+    
diff --git a/opt/wms_value.sh b/opt/wms_value.sh
index 329100d..64e973a 100755
--- a/opt/wms_value.sh
+++ b/opt/wms_value.sh
@@ -1,6 +1,8 @@
 #!/bin/sh
 
-# check if there is variable file in /tmp for source. if it's not there, copy it
+# check if there is variable file in /tmp for source. if it's not there, copy it ##
+# wms_value.sh by @root_informatica.
+
 if [ -f /tmp/wms_var ]; then
     . /tmp/wms_var
 else
diff --git a/wms_focuser.sh b/wms_focuser.sh
index b9fee1f..20fc120 100755
--- a/wms_focuser.sh
+++ b/wms_focuser.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
-## give windows the stardom ##
+## give windows the focus and put some color ##
+# wms_focuser.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var
 
diff --git a/wms_usher.sh b/wms_usher.sh
index 0c8a7c8..da4e502 100755
--- a/wms_usher.sh
+++ b/wms_usher.sh
@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## move and resize windows ##
+# wms_usher.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var 
 
diff --git a/wms_voyeur.sh b/wms_voyeur.sh
index 8e82f2d..c6db4c8 100755
--- a/wms_voyeur.sh
+++ b/wms_voyeur.sh
@@ -1,6 +1,8 @@
 #!/bin/sh
 
 ## snooping on xorg window events and doing some things ##
+## based on https://github.com/wmutils/contrib/blob/master/focus_watcher.sh ##
+# wms_voyeur.sh by @root_informatica.
 
 wew | while read ev wid args; do
     case $ev in