From Gentoo Wiki
Jump to:navigation Jump to:search

libinput is an input device driver for Wayland compositors and window system. It is Gentoo Linux's default input device driver.

libinput provides device detection, device handling, input device event processing and abstraction to minimize the amount of custom input code compositors need to provide the common set of functionality that users expect.[1]



Support for Event interface (CONFIG_INPUT_EVDEV) needs to be enabled in the kernel:

KERNEL Enabling Event interface in the kernel
Device Drivers --->
  Input device support --->
  <*>  Event interface

USE flags

USE flags for dev-libs/libinput Library to handle input devices in Wayland

doc Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally
test Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently)

Additional software

In order to enable actions gestures on the touchpad using the libinput driver, follow the install notes from the official project page on GitHub.

Remember to install the required dependencies:

root #emerge --ask x11-misc/xdotool x11-misc/wmctrl

Add user to the group input so devices can be read directly:

root #usermod -a -G input <user>



Some packages are aware of the libinput USE flag. It should already be set as the default input device driver by the make.defaults file.

To check if it is presently activated, run:

user $portageq envvar INPUT_DEVICES

If not, add it to the INPUT_DEVICES variable:

FILE /etc/portage/make.confSet INPUT_DEVICES

After setting the INPUT_DEVICES variable remember to update the system using the following command so the changes take effect:

root #emerge --ask --changed-use --deep @world

After the update the packages dev-libs/libinput and x11-drivers/xf86-input-libinput should be installed.

By default, when libinput is the only available input driver for Xorg, no additional configuration is needed. Simply (re)start the graphical environment for the changes to take effect.

If multiple input drivers are available on the system (x11-drivers/xf86-input-evdev and x11-drivers/xf86-input-synaptics for example), then additional configuration is required.

Selecting libinput

When multiple drivers are available on the system, Xorg must be instructed to use libinput before trying to use other input drivers. This can be simply performed by symlinking the 40-libinput.conf file into the /etc/X11/xorg.conf.d/ directory:

root #ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/

If the 40-libinput.conf will be edited, it is better to copy the file to the configuration directory:

root #cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/

Xorg gives priority to the files in the /etc/X11/xorg.conf.d/ directory.

(Re)start the graphical environment for the changes to take effect.

Touchpad disable middle button

Some laptops come with a middle button on their touchpad, which may be inconvenient and sometimes problematic for some users as it is often mis-clicked in place of the right or left button. It is possible to remove or remap that button by creating the following file:

FILE /etc/X11/xorg.conf.d/50-disable-middle-button.conf
Section "InputClass"
    Identifier "Disable Middle Button"
    MatchIsTouchpad "on"
    Option "ButtonMapping" "1 0 3"

This way the button will be rendered useless, but you can also change It to the left click by replacing "1 0 3" with "1 1 3" or wit the righ click with "1 3 3".

Touchpad tap-to-click

Many users will desire the native 'tap-to-click" behavior for laptops with modern touchpads. Add the following Option lines to Xorg's libinput configuration section:

FILE /etc/X11/xorg.conf.d/40-libinput.confAdding tap-to-click
Section "InputClass"
     Identifier "libinput touchpad catchall"
     MatchIsTouchpad "on"
     MatchDevicePath "/dev/input/event*"
     Option "Tapping" "True"
     Option "TappingDrag" "True"
     Driver "libinput"

Touchpad natural scrolling

Natural scrolling (swipe up on touchpad - content goes up and scrollbar goes down) can be achieved by adding the following options to the /etc/X11/xorg.conf.d/40-libinput.conf file:

FILE /etc/X11/xorg.conf.d/40-libinput.confAdding natural scrolling
Section "InputClass"
     Identifier "libinput touchpad catchall"
     MatchIsTouchpad "on"
     MatchDevicePath "/dev/input/event*"
     Option "NaturalScrolling" "True"
     Driver "libinput"

Of course, multiple options can be combined without needing to create a new Section each time.

Pointer acceleration

A permanent reduction of pointer acceleration:

FILE /etc/X11/xorg.conf.d/40-libinput.confSetting acceleration to 90%
Section "InputClass"
        Identifier "libinput pointer catchall"
        MatchIsPointer "on"
        Driver "libinput"
        Option "TransformationMatrix" "0.90 0 0 0 0.90 0 0 0 1"

It is also possible to disable the acceleration completely:

FILE /etc/X11/xorg.conf.d/50-touchpad.confDisabling acceleration on touchpad
Section "InputClass"
        Identifier "Thinkpad TouchPad"
        # See the result of 'xinput list'
        MatchProduct "SynPS/2 Synaptics TouchPad"
        Driver "libinput"
        Option "AccelProfile" "flat"

For more information, refer to the xorg.conf(5) man page.

The corresponding real-time test can be done using xinput. For example, for a Logitech G300s mouse :

user $xinput list
Virtual core pointer                    	id=2	[master pointer  (3)]
    ↳ Logitech G300s Optical Gaming Mouse     	id=10	[slave  pointer  (2)]
user $xinput list-props 10
Device 'Logitech G300s Optical Gaming Mouse':
	Coordinate Transformation Matrix (155):	1.000000, 0.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000, 0.000000, 1.000000
user $xinput set-prop 10 155 0.90 0 0 0 0.90 0 0 0 1


To list the available input devices:

root #libinput list-devices

For detailed information, refer to the libinput-list-devices(1) man page.

root #libinput debug-events

Further invocations need dev-python/python-libevdev installed:[2]

user $libinput replay
Error: No module named 'libevdev'
One or more python modules are missing. Please install those modules and re-run this tool.

For more details, refer to the libinput-replay(1) man page.

user $libinput measure
Usage: libinput measure [--help] <feature> [/dev/input/event0]

For more details, refer to the libinput-measure(1) man page.


Removing another input driver from INPUT_DEVICES does not prevent Xorg from loading it

This issue can occur in a variety of situations, but it is most prominent when migrating from evdev to libinput.

Be sure the x11-drivers/xf86-input-evdev package is no longer installed on the system. If /usr/share/X11/xorg.conf.d/10-evdev.conf exists then Xorg will still reference it.

Verify the evdev driver is no longer referenced anywhere by Portage (check make.conf and package.use), then depclean the system:

root #emerge --ask --depclean

Gnome overriding touchpad settings after system upgrade

As per this stack exchange post, recent versions (> 3.30.2 confirmed) of gnome override trackpad/touchpad options in configuration. This can for instance cause right-click to stop working. These settings are not visible in the usual settings menu - you need to use gnome-tweak-tool and look under 'Keyboard & Mouse' to change default behavior.

See also

  • Wayland — a replacement for the X11 window system protocol and architecture with the aim to be easier to develop, extend, and maintain
  • Wacom — provides instructions for enabling touchscreen support for Wacom devices such as laptops, tablets, and ultrabooks, and the like.
  • Xorg — an open source implementation of the X server.

External resources