summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJoshua Yun <joshua@joshuayun.com>2025-03-12 00:30:22 -0500
committerJoshua Yun <joshua@joshuayun.com>2025-03-12 00:30:22 -0500
commit4981aacb593c92bbc738d53f2b119fcccc7a300b (patch)
tree968a0516db32a4f804180b57084c1b046cbd27f7 /docs
parent59e1a7eafc2b73c009c1fa204ce4854b84a1b066 (diff)
downloadwiki-4981aacb593c92bbc738d53f2b119fcccc7a300b.tar.gz
Added wayland pageHEADmaster
Diffstat (limited to 'docs')
-rw-r--r--docs/desktop/desktop.md2
-rw-r--r--docs/desktop/wayland.md47
2 files changed, 49 insertions, 0 deletions
diff --git a/docs/desktop/desktop.md b/docs/desktop/desktop.md
index 816aea8..4f98d83 100644
--- a/docs/desktop/desktop.md
+++ b/docs/desktop/desktop.md
@@ -8,6 +8,8 @@ This page describes several useful tips and configurations that I've used.
[rclone mount reference](rclone.md)
+[wayland setup with dwl](wayland.md)
+
## Disabling ACPI for sleep
Somtimes we cannot sleep the computer due to ACPI devices being annoying.
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/)