PulseGesture

安装运行工具

Wayland 的可视化轨迹需要 XWayland；X11 会话安装同一组工具也不会产生影响。

sudo apt update
sudo apt install xwayland xdg-utils unzip

加入 input 用户组

创建 input 组（如不存在），并将当前用户加入该组。

getent group input >/dev/null || sudo groupadd --system input
sudo usermod -aG input "$USER"

启用 uinput

立即加载内核模块，并设置为以后每次开机自动加载。

sudo modprobe uinput
echo uinput | sudo tee /etc/modules-load.d/pulse-gesture.conf >/dev/null
ls -l /dev/uinput

安装 udev 规则

写入设备身份和访问权限规则，然后让 udev 重新加载并应用规则。

/etc/udev/rules.d/69-pulse-gesture.rules

sudo tee /etc/udev/rules.d/69-pulse-gesture.rules >/dev/null <<'EOF'
ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{phys}=="pulse-gesture/*", ATTRS{id/bustype}=="0003", ENV{ID_BUS}="usb"
ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{phys}=="pulse-gesture/*", ATTRS{id/bustype}=="0005", ENV{ID_BUS}="bluetooth"
EOF

/etc/udev/rules.d/99-pulse-gesture.rules

sudo tee /etc/udev/rules.d/99-pulse-gesture.rules >/dev/null <<'EOF'
KERNEL=="event*", SUBSYSTEM=="input", MODE="0660", GROUP="input"
KERNEL=="uinput", SUBSYSTEM=="misc", MODE="0660", GROUP="input", OPTIONS+="static_node=uinput"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=input --action=change
sudo udevadm trigger --subsystem-match=misc --action=change
sudo udevadm settle

重启系统

新增的用户组权限不会在当前会话中生效，重启是最稳妥的方式。

sudo reboot

检查桌面会话

X11：XDG_SESSION_TYPE 应为 x11，DISPLAY 不能为空。

printf 'session=%s\ndisplay=%s\n' "$XDG_SESSION_TYPE" "$DISPLAY"

Wayland：WAYLAND_DISPLAY 和 DISPLAY 都应存在，并确保 XWayland 正在运行或可以按需启动。

printf 'session=%s\nwayland=%s\ndisplay=%s\n' \
  "$XDG_SESSION_TYPE" "$WAYLAND_DISPLAY" "$DISPLAY"
pgrep -a Xwayland || true