libinput is a library to handle input devices in Wayland compositors and to provide a generic X.Org input driver. It provides device detection, device handling, input device event processing and abstraction so minimize the amount of custom input code compositors need to provide the common set of functionality that users expect.
This wiki page provides high-level information, documentation about libinput's API and examples are available in the API documentation.
- 1.0 - released August 26, 2015
- 1.1 - released Oct 26, 2015
- 1.2 - released Feb 23, 2016
- 1.3 - released May 10, 2016
- 1.4 - released Jul 18, 2016
As of the 0.12 release, the API/ABI is stable.
cgit Web Frontend
Feature-specific documentation is available in the Related Pages section of the API documentation.
A note on feature requests
Source tarballs are available http://www.freedesktop.org/software/libinput/
Development and discusssion of libinput happens on the firstname.lastname@example.org mailing list. Please submit patches to this list as well.
libinput has a bugzilla component under the Wayland product freedesktop.org Bugzilla
Note that in almost all cases we require extra information to be able to triage and fix the bug correctly. Please read the Reporting Bugs section.
X.Org libinput driver
The X.Org libinput driver is a thin wrapper around libinput and allows for libinput to be used for input devices in X. This driver can be used as as drop-in replacement for evdev and synaptics. Simply build and install in your $PREFIX, then install the config file in /etc/X11/xorg.conf.d/. Restart X and the libinput driver will take over your devices.