1 files changed, 47 insertions, 0 deletions
diff --git a/docs/desktop/wayland.md b/docs/desktop/wayland.md
new file mode 100644
index 0000000..12ddfc6
--- /dev/null
+++ b/docs/desktop/wayland.md
@@ -0,0 +1,47 @@
+# Wayland installation
+
+## dwl and dwlb
+
+Follow installation instructions from dwl + dwlb to compile the two packages and install theme
+
+Create a startup script or put into .bash_profile the following command to allow dwl to start correctly:
+
+    exec dbus-run-session dwl -s 'dwlb -font "HackNerdFont:size=16"'
+
+dwl requires that a status bar be provided for -s, in this case we are using dwlb
+
+References:
+
+[Arch Linux Article](https://wiki.archlinux.org/title/Dwl)
+
+Software:
+
+[dwlb](https://github.com/kolunmi/dwlb)
+[dwl](https://codeberg.org/dwl/dwl)
+[wmenu](https://codeberg.org/adnano/wmenu)
+
+## Escape + Super key mapping
+
+Since wayland does not have support for xcape, we need to use interception with a plugin instead.
+The following link goes over how to install and use the interception plugin.
+
+These are the configurations for my setup:
+
+/etc/interception/dual-function-keys/mappings.yml:
+
+    MAPPINGS:
+        - KEY: KEY_CAPSLOCK
+          TAP: KEY_ESC
+          HOLD: KEY_LEFTMETA
+
+/etc/interception/udevmon.d/rivos-laptop-udevmon.yml:
+
+    - JOB: "intercept -g $DEVNODE | dual-function-keys -c /etc/interception/dual-function-keys/mappings.yml | uinput -d $DEVNODE"
+      DEVICE:
+        NAME: "AT Translated Set 2 keyboard"
+
+To get the device name: see the reference link.
+
+References:
+
+[interception](https://gitlab.com/interception/linux/plugins/dual-function-keys/)