LIBINPUT(4)

NAME
libinput - libinput-based X.Org input driver

SYNOPSIS
Section "InputDevice"
  Identifier "devname"
  Driver "libinput"
  Option "Device"   "devpath"
  ...
EndSection

NOTE
This is the man page for the X input driver. If you are looking for the library documentation, go to http://wayland.freedesktop.org/libinput/doc/

DESCRIPTION
libinput is an Xorg input driver based on libinput. It therefore supports all input devices that libinput can handle, including most mice, keyboards, tablets and touchscreens.

It is recommended that libinput devices are configured through the InputClass directive (refer to xorg.conf(5)) instead of manual per-device configuration. Devices configured in the xorg.conf(5) are not hot-plug capable.

CONFIGURATION DETAILS
Please refer to xorg.conf(5) for general configuration details and for options that can be used with all input drivers. This section only covers configuration details specific to this driver.

The following driver Options are supported:

Option "Device" "string"
    Specifies the device through which the device can be accessed. This will generally be of the form "/dev/input/eventX", where X is some integer. The mapping from device node to hardware is system-dependent. Property: "Device Node" (read-only).

Option "AccelSpeed" "float"
    Sets the pointer acceleration speed within the range [-1, 1]

Option "CalibrationMatrix" "string"
    A string of 9 space-separated floating point numbers. Sets the calibration matrix to the 3x3 matrix where the first row is (abc), the second row is (def) and the third row is (ghi).

Option "LeftHanded" "bool"
    Enables left-handed button orientation, i.e. swapping left and right buttons.

Option "NaturalScrolling" "bool"
    Enables or disables natural scrolling behavior.

Option "ScrollButton" "int"
    Designates a button as scroll button. If the ScrollMethod is button and the button is logically held down, x/y axis movement is converted into scroll events.

Option "ScrollMethod" "string"
    Enables a scroll method. Permitted values are none, twofinger, edge, button. Not all devices support all options, if an option is unsupported, the default scroll option for this device is used.

Option "SendEventsMode" "(disabled|enabled|disabled-on-external-mouse)"
    Sets the send events mode to disabled, enabled, or "disable when an external mouse is connected".

Option "Tapping" "bool"
    Enables or disables tap-to-click behavior.

For all options, the options are only parsed if the device supports that configuration option. For all options, the default value is the one used by libinput. On configuration failure, the default value is applied.

SUPPORTED PROPERTIES
The following properties are provided by the libinput driver.

libinput Tapping Enabled
    1 boolean value (8 bit, 0 or 1). 1 enables tapping

libinput Calibration Matrix
    9 32-bit float values, representing a 3x3 calibration matrix, order is row 1, row 2, row 3

libinput Accel Speed
    1 32-bit float value, defines the pointer speed. Value range -1, 1

libinput Natural Scrolling Enabled
    1 boolean value (8 bit, 0 or 1). 1 enables natural scrolling

libinput Send Events Mode
    1 32-bit value, defines the sendevent mode. See the libinput documentation for the allowed values.

AUTHORS
Peter Hutterer

SEE ALSO
Xorg(1), xorg.conf(5), Xserver(1), X(7)