Touchpad¶
Description¶
Acceleration¶
Touchpad triggers are unaccelerated, this also applies to the move_by_delta mouse input action.
libevdev backend¶
The libevdev input backend supplies the following touchpad data, which libinput does not:
absolute position of each finger,
pressure of each finger (usually the surface area but some devices provide true pressure),
clicked state (only on touchpads that can be clicked).
This enables the following features:
finger_andthumb_variables (thumb detection requires the pressure range to be set, see TouchpadProperties),one-finger swipe/stroke triggers,
click trigger,
tap trigger.
Additional setup instructions are required to enable those features.
One-finger swipe/stroke triggers¶
One-finger swipe triggers use the pointer’s unaccelerated delta and lock its position for the duration of the trigger. The sensitivity may be different compared to other triggers. Actions that move the pointer will not work.
On Hyprland, the pointer is not locked and the accelerated delta is used instead.
Two-finger swipe/stroke triggers¶
Two-finger swipe triggers are achieved by treating scroll events as two-finger motion events. The thresholds for changing the scroll axis are quite large, which
can cause unexpected behavior with stroke triggers and direction: any swipe triggers utilizing the move_by_delta mouse input action. For two-finger
stroke triggers it is recommended (but not required) to only use strokes that have been recorded using two fingers.
This feature will not work if scrolling on edges is enabled.
Five-finger triggers¶
Libinput does not support five-finger gestures, click and tap triggers are an exception, as they are managed by InputActions.
TouchpadEventHandler¶
Inherits EventHandler.
Property |
Type |
Description |
Default |
|---|---|---|---|
devices |
map(string, TouchpadProperties) |
Device properties where the key is the device name, which can be obtained from variables. Some properties are detected automatically, but due to device or driver bugs, the value may be incorrect, in which case the user must override it manually. |
|
click_timeout |
time |
The time during which a click trigger must be performed. If not, a press trigger will be started. |
|
delta_multiplier |
float |
Delta multiplier used for move_by_delta mouse input actions. |
|
TouchpadProperties¶
Property |
Type |
Description |
Default |
|---|---|---|---|
buttonpad |
bool |
Whether the touchpad is a buttonpad (no physical buttons below, the entire device is a button). Detected automatically. |
|
pressure_ranges.finger |
uint |
Minimum pressure for the touch point to be considered a finger. Everything below this value will be ignored. |
|
pressure_ranges.thumb |
uint |
Minimum pressure for the touch point to be considered a thumb. Required for |
|
pressure_ranges.palm |
uint |
Minimum pressure for the touch point to be considered a palm. Everything over this value will be ignored. |
|