litle changes.

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**

art/wms.ascii

@@ -1,8 +1,25 @@
-━━━━━━━━━━━━━━
-━━━━━━━━━━━━━━
-┏┓┏┓┏┓┏┓┏┓┏━━┓
-┃┗┛┗┛┃┃┗┛┃┃━━┫
-┗┓┏┓┏┛┃┃┃┃┣━━┃
-━┗┛┗┛━┗┻┻┛┗━━┛
-━━━━━━━━━━━━━━
-━━━━━━━━━━━━━━
+
+┌─────────────────────────────────────────┐
+│               ..:::/::-.                │
+│             `-:::-::-::::`              │
+│            `:::-::::-:::--              │
+│            .:::::::::://-/.             │
+│            .::::::::-::::/.             │
+│             :`  `.//-`  .:              │
+│             :-----:--.---:              │
+│      `..`   `--::::::::--.   ```        │
+│      -:::-`    .:-::::-    `-:::.       │
+│     `:::::::-.`  ````` ..-:::::/:       │
+│      ``` ..--::-:....-::::..````        │
+│              `.::-::::--.               │
+│      `--.--::::-.`  `.-::/:-...-`       │
+│      .::::..`            ``-::::.       │
+│      .::`                    .::-       │
+│      `.`                      ...       │
+│  .____                           ____.  │
+│  |   _| __  _  _______   ______ |_   |  │
+│  |  |   \ \/ \/ /     \ /  ___/   |  |  │
+│  |  |    \     /  Y Y  \\___ \    |  |  │
+│  |  |_    \/\_/|__|_|  /____  >  _|  |  │
+│  |____|              \/     \/  |____|  │
+└─────────────────────────────────────────┘

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

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

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

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 
 

opt/wms_clearer.sh

@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## clean screen ##
+# wms_clearer.sh by @root_informatica.
 
 . /tmp/wms_var
 

opt/wms_jumper.sh

@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## switch between windows ##
+# wms_jumper.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var
 

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
 

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.

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 
 

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

opt/wms_termrename.sh

@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## rename terminals ##
+# wms_termrename.sh by @root_informatica.
 
 . /tmp/wms_var
 

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
+
+    
+    

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

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
 

wms_usher.sh

@@ -1,6 +1,7 @@
 #!/bin/sh
 
 ## move and resize windows ##
+# wms_usher.sh by @root_informatica.
 
 . $HOME/.config/wms/wms_var 
 

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