Disable Touchpad in Hyprland

Hyprland is a dynamic tiling Wayland compositor that offers extensive customization options. If you want to disable the touchpad on your system while using Hyprland, you can do so by following these steps.

Hyprland 是一个动态平铺的 Wayland 合成器，提供了广泛的自定义选项。如果您想在使用 Hyprland 时禁用触摸板，可以按照以下步骤操作。

Step 1: Identify Your Touchpad Device#

1
hyprctl devices

Firstly, use this command to list all input devices connected to your system. Here, hyprctl is the command-line tool for Hyprland. The devices parameter is used to list all recognized input devices. Find the device that contains “touchpad” in its name and note down its name.

首先，使用此命令列出连接到系统的所有输入设备。其中hyprctl是 Hyprland 的命令行工具。devices参数用于列出所有已识别的输入设备。找到带有“touchpad”字样的设备，并记下其名称。

sample output:

1
Mouse at 55d441d40460:
2
  asuf1207:00-2808:0219-touchpad  # Device name: asuf1207:00-2808:0219-touchpad
3
    default speed: 0.00000
4
    scroll factor: -1.00

NOTE
The output of the command is typically organized by device type:
通常，这条命令的输出按设备类型组织：

Mice: Shows the device name, speed, and other properties.

Keyboards: Lists the name, rules, active keymap, and the status of Caps Lock and Num Lock.

Tablets: Displays information for touchscreens and styluses.

Touch: Provides details about touch input devices.

Switches: Provides details about any other input-related devices, like power/lid events.

However, the touchpad does not always appear under the “Touch” category; sometimes it may be recognized as a mouse device, so make sure to check the device list carefully.
然而，触摸板并不会总是出现在“Touch”类别下，有时它会被识别为鼠标设备，因此请确保仔细检查设备列表。

Step 2: Disable the Touchpad#

NOTE
If you only want to disable the touchpad while typing to avoid accidental cursor movements, you can add the following section to your Hyprland configuration file:
如果您只想在打字时禁用触摸板以避免误触，可以将以下部分添加到您的 Hyprland 配置文件中：
1
input {
2
    touchpad {
3
        disable_while_typing = true
4
    }
5
}
More options for touchpad configuration can be found in the Hyprland Wiki - Touchpad Variable.

Using hyprctl CLI#

Use the following command to disable the touchpad by replacing <device_name> with the actual name of your touchpad device identified in Step1.

使用以下命令禁用触摸板，将<device_name>替换为在步骤 1 中识别的实际触摸板设备名称。

1
hyprctl keyword 'device[<device_name>]:enabled' 'false'

Using Hyprland Configuration File#

Set Keybindings#

Alternatively, you can disable the touchpad by adding a line to your Hyprland configuration file, typically located at ~/.config/hypr/hyprland.conf. The following example maps the key combination Super + Alt + P to disable the touchpad and Ctrl + Super + Alt + P to enable it again.

另外，您也可以通过将一行添加到您的 Hyprland 配置文件（通常位于~/.config/hypr/hyprland.conf）中来禁用触摸板。以下示例将键组合Super + Alt + P映射为禁用触摸板，Ctrl + Super + Alt + P则重新启用它。

1
bind = Super+Alt, P, exec, hyprctl keyword 'device[<device_name>]:enabled' 'false' # Disable touchpad
2
bind = Ctrl+Super+Alt, P, exec, hyprctl keyword 'device[<device_name>]:enabled' 'true' # Enable touchpad

Here, bind is used to create key bindings. exec indicates that the following command should be executed when the key combination is pressed.

在这里，bind用于创建键绑定。exec表示当按下键组合时应执行后续命令。

Create a Toggle Script#

1
#!/usr/bin/env bash
2

3
#
4
# Script to toggle a given device.
5
# Use the following command to choose what device you want to toggle:
6
#   hyprctl devices
7
#
8
# Replace <device_name> with your touchpad device name in the line below.
9
#
10
# The script will create a status file at $XDG_RUNTIME_DIR/touchpad.status
11
# to remember the last known status of the touchpad.
12
# If the file does not exist, it assumes the touchpad is enabled by default.
13
#
14

15
# HACK: Try to set a nonexistent config under "device:" so that
16
# Hyprland refreshes all properties inside.
17
hyprctl keyword device:a true > /dev/null 2>&1
18

19
# Set device to be toggled
20
HYPRLAND_DEVICE=<device_name> # Replace <device_name> with your touchpad device name
21
export HYPRLAND_VARIABLE="device[${HYPRLAND_DEVICE}]:enabled"
22

23
if [ -z "$XDG_RUNTIME_DIR" ]; then
24
  export XDG_RUNTIME_DIR=/run/user/$(id -u)
25
fi
26

27
# Check if device is currently enabled
28
export STATUS_FILE="$XDG_RUNTIME_DIR/touchpad.status"
29

30
# Try to get the touchpad status from status file.
31
if [ -f "$STATUS_FILE" ]; then
32
  export TOUCHPAD_ENABLED="$(cat "$STATUS_FILE")"
33
fi
34

35
# Toggle the touchpad
36
if [ "$TOUCHPAD_ENABLED" != "false" ]; then
37
  # The touchpad is known to be, or assumed to be, enabled (not disabled).
38
  export PREVIOUS_STATUS="true"
39
  export TOUCHPAD_ENABLED="false"
40
  # Try to disable the touchpad. If it fails, set the new status to enabled.
41
  hyprctl --batch -r -- keyword "$HYPRLAND_VARIABLE" $TOUCHPAD_ENABLED || export TOUCHPAD_ENABLED="true"
42
else
43
  # The touchpad is known to be disabled.
44
  export PREVIOUS_STATUS="false"
45
  export TOUCHPAD_ENABLED="true"
46
  # Try to enable the touchpad. If it fails, set the new status to disabled.
47
  hyprctl --batch -r -- keyword "$HYPRLAND_VARIABLE" $TOUCHPAD_ENABLED || export TOUCHPAD_ENABLED="false"
48
fi
49

50
# Write the new touchpad status into the status file.
51
echo "$TOUCHPAD_ENABLED" > "$STATUS_FILE"
52

53
# Generate the notification message.
54
export NOTIFMSG="Touchpad "
55

56
if [ "$TOUCHPAD_ENABLED" == "$PREVIOUS_STATUS" ]; then
57
  export NOTIFMSG+="could not be "
58
  # Touchpad could not be...
59
fi
60

61
if [ "$PREVIOUS_STATUS" == "true" ]; then
62
  export NOTIFMSG+="disabled."
63
  # Touchpad (could not be) disabled.
64
else
65
  export NOTIFMSG+="enabled."
66
  # Touchpad (could not be) enabled.
67
fi
68

69
notify-send -u normal "$NOTIFMSG" # Send notification(delete this line if you don't want notifications)

Save this script to a file, for example touchpad_toggle.sh, and make it executable with:

保存此脚本到一个文件，例如 touchpad_toggle.sh，并通过以下命令使其可执行：

1
chmod +x touchpad_toggle.sh

The binding in the Hyprland configuration file would look like this:

与之对应的 Hyprland 配置文件中的绑定如下所示：

1
bind = Super+Alt, P, exec, /path/to/touchpad_toggle.sh # Toggle touchpad

Welcome to Yurika!