gnoblin.configure.input.touchpad

Set only the touchpad behavior you want to override. Unspecified fields keep their current GNOME/Mutter values. Changes apply on configuration reload. This example enables tap-to-click and two-finger scrolling:

gnoblin.configure {
    input = {
        touchpad = {
            tap_to_click = true,
            two_finger_scrolling_enabled = true,
        },
    },
}

Pointer behavior

Field	Accepted values	What it changes
speed	Number from -1 to 1	-1 is unaccelerated, 1 is fast, and 0 uses the system default.
scroll_speed	Number from 0 to 2	Scales two-finger and touchpad scrolling. 1 is the default speed, 0.5 is half speed, and 2 is twice the speed.
accel_profile	"default", "flat", "adaptive", or "custom"	Selects the system curve or a custom profile.
accel_curve	{step = number, points = number[]}	Defines custom pointer acceleration. Requires accel_profile = "custom"; it affects pointer motion, not scrolling.
left_handed	"right", "left", or "mouse"	Selects the touchpad button order; "mouse" follows the mouse setting.
natural_scroll	Boolean	Reverses the scroll direction.

Gestures

Field	Accepted values	Meaning
tap_to_click	Boolean	Click by tapping the touchpad.
tap_and_drag	Boolean	Drag by tapping, then moving a finger.
tap_and_drag_lock	Boolean	Keep a tap-and-drag active briefly after lifting your finger.
disable_while_typing	Boolean	Helps prevent pointer movement from a resting palm while typing.
edge_scrolling_enabled	Boolean	Scroll along the touchpad edge, if supported.
two_finger_scrolling_enabled	Boolean	Scroll by moving two fingers, if supported.

Click mapping

Field	Accepted values	Meaning
tap_button_map	"default", "lrm", or "lmr"	"lrm" maps one-, two-, and three-finger taps to left, right, and middle click. "lmr" swaps the two- and three-finger mappings.
click_method	"default", "none", "areas", or "fingers"	Keep hardware behavior, disable software-emulated clicks, or emulate clicks using click areas or finger counts.

Each field defaults to the current device preference when omitted. The "default" enum value asks GNOME/libinput to choose the device behavior.

Set the initial scroll speed from the window under the pointer when the config loads. Keyboard focus does not affect which window the event reports:

gnoblin.on("pointer_window_changed", function(event)
    local speed = event.app_id == "org.chromium.Chromium" and 0.3 or 1.0
    gnoblin.configure {input = {touchpad = {scroll_speed = speed}}}
end)

The callback table includes app_id, wm_class, and title. This event runs when the config loads; it does not track pointer movement continuously. See the Lua event API for its payload and callback behavior.

For accel_curve, use a positive step and at least two finite, non-negative points. The points define output speed at evenly spaced input speeds in device units per millisecond. libinput interpolates between points and extrapolates beyond the last one. Its implementation sets the maximum number of points. When the custom curve is active, libinput ignores speed for pointer behavior.

The available gestures depend on the touchpad hardware. GNOME's touchpad guide explains tap, click, and scroll behavior. The libinput acceleration guide explains the curve units and behavior.

Type definition

This is schema pseudocode in Lua table form. ? marks an optional field; | separates accepted alternatives.

gnoblin.configure {
    input = {
        touchpad = {
            speed = number?, -- -1 to 1
            scroll_speed = number?, -- 0 to 2
            accel_profile = "default" | "flat" | "adaptive" | "custom"?,
            accel_curve = {step = number, points = number[]}?,
            left_handed = "right" | "left" | "mouse"?,
            natural_scroll = boolean?,
            tap_to_click = boolean?,
            tap_and_drag = boolean?,
            tap_and_drag_lock = boolean?,
            disable_while_typing = boolean?,
            edge_scrolling_enabled = boolean?,
            two_finger_scrolling_enabled = boolean?,
            tap_button_map = "default" | "lrm" | "lmr"?,
            click_method = "default" | "none" | "areas" | "fingers"?,
        },
    },
}