gnoblin.configure.input.mouse

Set only the mouse options you want to change. Gnoblin leaves omitted options at their current GNOME/Mutter values, so a small override keeps the rest of your pointer preferences intact.

On this page

Type definition

For example, this sets a left-handed button layout, a custom acceleration curve, and a double-click time of 350 milliseconds:

Lua

gnoblin.configure {
    input = {
        mouse = {
            speed = -0.2,
            double_click_time = 350,
            middle_click_emulation = true,
            left_handed = true,
            accel_profile = "custom",
            accel_curve = {step = 1.0, points = {0.0, 1.0, 2.0, 4.0}},
        },
    },
}

Field	Accepted values	Default when omitted	What it changes
`speed`	Number from `-1` to `1`	Current device preference	`-1` is unaccelerated, `1` is fast, and `0` asks the system for its default speed.
`double_click_time`	Integer from `0` to `2147483647` milliseconds	Current system preference (normally `400`)	Time between presses for Mutter to count them as a double-click.
`drag_threshold`	Integer from `1` to `2147483647`	Current system preference (normally `8`)	Pointer distance in pixels before Mutter treats movement as a drag.
`middle_click_emulation`	Boolean	Current device preference (normally off)	Enables middle-click when the left and right buttons are pressed together.
`left_handed`	Boolean	Current device preference	Swaps the primary mouse buttons.
`natural_scroll`	Boolean	Current device preference	Reverses the scroll direction.
`accel_profile`	`"default"`, `"flat"`, `"adaptive"`, or `"custom"`	Current profile	Selects the system curve or a custom profile.
`accel_curve`	`{step = number, points = number[]}`	Current system curve	Sets pointer speed at evenly spaced input speeds. Requires `accel_profile = "custom"`.

If a device does not support the selected acceleration profile, it uses its default profile.

For a custom profile, step must be greater than zero. points must contain at least two finite, non-negative numbers. The first point is the output speed at input speed zero.

Each later point is spaced step device units per millisecond farther along the input-speed axis. libinput linearly interpolates between points and extrapolates beyond the last point. The maximum number of points is set by libinput.

The curve changes pointer motion; it does not define a separate scroll curve. When a custom curve is active, libinput ignores speed for pointer behavior.

Omitted values keep the current GNOME/Mutter preference for that device. Every field also accepts "inherit" to restore that preference when an earlier config file supplied a value.

While double_click_time is set, Gnoblin applies it to Mutter's click handling. Removing the field or setting it to "inherit" restores the current system preference. drag_threshold follows the same inheritance rule for drag handling. middle_click_emulation follows it for middle-click emulation. GNOME's pointer-speed guide explains the user-facing speed setting. The libinput guide explains the units and interpolation used by custom curves.

Type definition

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

Lua

gnoblin.configure {
    input = {
        mouse = {
            speed = number?, -- -1 to 1
            double_click_time = integer?, -- 0 to 2147483647 milliseconds
            drag_threshold = integer?, -- 1 to 2147483647 pixels
            middle_click_emulation = boolean?,
            left_handed = boolean?,
            natural_scroll = boolean?,
            accel_profile = "default" | "flat" | "adaptive" | "custom"?,
            accel_curve = {step = number, points = number[]}?,
        },
    },
}