summaryrefslogtreecommitdiff
path: root/Software/libinput.mdwn
blob: 51e22da926a10da1729533a862afa529aec8595c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
# libinput

libinput is a library to handle input devices in [Wayland](http://wayland.freedesktop.org) compositors and to provide a generic [X.Org](http://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 only basic information, please see the [libinput documentation](http://wayland.freedesktop.org/libinput/doc/latest/) for details.

## Releases
* [1.0 - released August 26, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-August/024085.html)
 * [1.0.1 - released Sep 3, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-September/024149.html)
 * [1.0.2 - released Oct 20, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-October/025010.html)
* [1.1 - released Oct 26, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-October/025065.html)
 * [1.1.1 - released Nov 16, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-November/025436.html)
 * [1.1.2 - released Dec 09, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-December/026041.html)
 * [1.1.3 - released Dec 16, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-December/026157.html)
 * [1.1.4 - released Dec 22, 2015](http://lists.freedesktop.org/archives/wayland-devel/2015-December/026233.html)
 * [1.1.5 - released Jan 25, 2016](http://lists.freedesktop.org/archives/wayland-devel/2016-January/026701.html)
 * [1.1.6 - released Feb 05, 2016](http://lists.freedesktop.org/archives/wayland-devel/2016-February/026874.html)
 * [1.1.7 - released Feb 10, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-February/026964.html)
* [1.2 - released Feb 23, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-February/027172.html)
 * [1.2.1 - released Feb 29, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-February/thread.html)
 * [1.2.2 - released Mar 15, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-March/027456.html)
 * [1.2.3 - released Apr 12, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-April/027993.html)
* [1.3 - released May 10, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-May/028704.html)
 * [1.3.1 - released May 30, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-May/029126.html)
 * [1.3.2 - released Jun 16, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-June/029485.html)
 * [1.3.3 - released Jun 24, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-June/029680.html)
* [1.4 - released Jul 18, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-July/030121.html)
 * [1.4.1 - released Aug 05, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-August/030348.html)
 * [1.4.2 - released Aug 30, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-August/030857.html)
 * [1.4.3 - released Sep 23, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-September/031134.html)
* [1.5 - released Sep 14, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-September/031054.html)
 * [1.5.1 - released Nov 11, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-November/031527.html)
 * [1.5.2 - released Nov 25, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-November/031926.html)
 * [1.5.3 - released Dec 07, 2016](https://lists.freedesktop.org/archives/wayland-devel/2016-December/032110.html)
 * [1.5.4 - released Jan 13, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-January/032610.html)
* [1.6.0 - released Jan 20, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-January/032746.html)
 * [1.6.1 - released Feb 02, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-February/032940.html)
 * [1.6.2 - released Feb 21, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-February/033169.html)
 * [1.6.3 - released Mar 8, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-March/033377.html)
* [1.7.0 - released Mar 23, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-March/033531.html)
 * [1.7.1 - released Apr 25, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-April/033962.html)
 * [1.7.2 - released May 05, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-May/034037.html)
 * [1.7.3 - released Jun 09, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-June/034261.html)
* [1.8.0 - released Jul 03, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-July/034397.html)
 * [1.8.1 - released Jul 19, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-July/034525.html)
 * [1.8.2 - released Sep 7, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-September/034949.html)
 * [1.8.3 - released Oct 4, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-October/035332.html)
 * [1.8.4 - released Oct 30, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-October/035573.html)
* [1.9.0 - released Oct 19, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-October/035469.html)
 * [1.9.1 - released Oct 30, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-October/035575.html)
 * [1.9.2 - released Nov 15, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-November/035817.html)
 * [1.9.3 - released Nov 28, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-November/035968.html)
 * [1.9.4 - released Dec 14, 2017](https://lists.freedesktop.org/archives/wayland-devel/2017-December/036232.html)
* [1.10.0 - released Feb 13, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-February/036957.html)
 * [1.10.1 - released Feb 28, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-February/037258.html)
 * [1.10.2 - released March 7, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-March/037317.html)
 * [1.10.3 - released March 14, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-March/037364.html)
 * [1.10.4 - released Apr 09, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-April/037758.html)
 * [1.10.5 - released Apr 19, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-April/037934.html)
 * [1.10.6 - released May 01, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-May/038052.html)
 * [1.10.7 - released May 18, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-May/038187.html)
* [1.11.0 - released Jun 05, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-June/038349.html)
 * [1.11.1 - released Jun 19, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-June/038547.html)
 * [1.11.2 - released Jul 03, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-July/038782.html)
 * [1.11.3 - released Jul 25, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-July/039137.html)
* [1.12.0 - released Sep 11, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-September/039450.html)
 * [1.12.1 - released Oct 03, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-October/039502.html)
 * [1.12.2 - released Oct 24, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-October/039553.html)
 * [1.12.3 - released Nov 07, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-November/039620.html)
 * [1.12.4 - released Dec 18, 2018](https://lists.freedesktop.org/archives/wayland-devel/2018-December/039782.html)
 * [1.12.5 - released Jan 7, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-January/039804.html)
 * [1.12.6 - released Jan 21, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-January/039864.html)
* [1.13.0 - released Mar 29, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-March/040363.html)
 * [1.13.1 - released Apr 9, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-April/040403.html)
 * [1.13.2 - released May 9, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-May/040548.html)
 * [1.13.3 - released June 24, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-June/040650.html)
 * [1.13.4 - released June 28, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-June/040675.html)
* [1.14.0 - released Aug 08, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-August/040790.html)
 * [1.14.1 - released Aug 26, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-August/040814.html)
 * [1.14.2 - released Oct 18, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-October/040936.html)
 * [1.14.3 - released Oct 28, 2019](https://lists.freedesktop.org/archives/wayland-devel/2019-October/040967.html)
* [1.15.0 - released Jan 03, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-January/041115.html)
 * [1.15.1 - released Feb 03, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-February/041186.html)
 * [1.15.2 - released Feb 20, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-February/041227.html)
 * [1.15.3 - released Mar 06, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-March/041288.html)
 * [1.15.4 - released Mar 18, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-March/041332.html)
 * [1.15.5 - released Apr 11, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-April/041400.html)
 * [1.15.6 - released Jun 19, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-June/041478.html)
* [1.16.0 - released Aug 03, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-August/041578.html)
 * [1.16.1 - released Aug 13, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-August/041590.html)
 * [1.16.2 - released Oct 07, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-October/041640.html)
 * [1.16.3 - released Nov 03, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-November/041644.html)
 * [1.16.4 - released Nov 27, 2020](https://lists.freedesktop.org/archives/wayland-devel/2020-November/041664.html)
 * [1.16.5 - released Feb 24, 2020](https://lists.freedesktop.org/archives/wayland-devel/2021-February/041734.html)
* [1.17.0 - released Feb 23, 2020](https://lists.freedesktop.org/archives/wayland-devel/2021-February/041733.html)
 * [1.17.1 - released March 24, 2021](https://lists.freedesktop.org/archives/wayland-devel/2021-March/041758.html)
 * [1.17.2 - released Apr 30, 2021](https://lists.freedesktop.org/archives/wayland-devel/2021-April/041809.html)
 * [1.17.3 - released May 26, 2021](https://lists.freedesktop.org/archives/wayland-devel/2021-May/041834.html)
* [1.18.0 - released Jun 02, 2021](https://lists.freedesktop.org/archives/wayland-devel/2021-June/041849.html)
 * [1.18.1 - released Aug 03, 2021](https://lists.freedesktop.org/archives/wayland-devel/2021-August/041934.html)

### Earlier releases
As of the 0.12 release, the API/ABI is stable.

[0.1.0](http://lists.freedesktop.org/archives/wayland-devel/2014-February/013475.html),
[0.2.0](http://lists.freedesktop.org/archives/wayland-devel/2014-May/014989.html),
[0.3.0](http://lists.freedesktop.org/archives/wayland-devel/2014-June/015378.html),
[0.4.0](http://lists.freedesktop.org/archives/wayland-devel/2014-June/015589.html),
[0.5.0](http://lists.freedesktop.org/archives/wayland-devel/2014-July/016136.html),
[0.6.0](http://lists.freedesktop.org/archives/wayland-devel/2014-September/017224.html),
[0.7.0](http://lists.freedesktop.org/archives/wayland-devel/2014-December/018750.html),
[0.8.0](http://lists.freedesktop.org/archives/wayland-devel/2015-January/019383.html),
[0.9.0](http://lists.freedesktop.org/archives/wayland-devel/2015-January/019692.html),
[0.10.0](http://lists.freedesktop.org/archives/wayland-devel/2015-February/019827.html),
[0.11.0](http://lists.freedesktop.org/archives/wayland-devel/2015-February/020126.html),
[0.12.0](http://lists.freedesktop.org/archives/wayland-devel/2015-March/020475.html),
[0.13.0](http://lists.freedesktop.org/archives/wayland-devel/2015-March/020833.html),
[0.14.0](http://lists.freedesktop.org/archives/wayland-devel/2015-April/021484.html),
[0.14.1](http://lists.freedesktop.org/archives/wayland-devel/2015-April/021485.html),
[0.15.0](http://lists.freedesktop.org/archives/wayland-devel/2015-May/021773.html),
[0.16.0](http://lists.freedesktop.org/archives/wayland-devel/2015-June/022400.html),
[0.17.0](http://lists.freedesktop.org/archives/wayland-devel/2015-June/022448.html),
[0.18.0](http://lists.freedesktop.org/archives/wayland-devel/2015-June/022798.html),
[0.19.0](http://lists.freedesktop.org/archives/wayland-devel/2015-July/023184.html),
[0.20.0](http://lists.freedesktop.org/archives/wayland-devel/2015-July/023434.html),
[0.21.0](http://lists.freedesktop.org/archives/wayland-devel/2015-August/023783.html),
[0.99.1](http://lists.freedesktop.org/archives/wayland-devel/2015-August/024004.html)

## git Repository
* <https://gitlab.freedesktop.org/libinput/libinput/>

## Documentation
* [User-specific documentation](http://wayland.freedesktop.org/libinput/doc/latest/)
* [API documentation (development branch)](http://wayland.freedesktop.org/libinput/doc/latest/api/)
* [Release-specific documentation](http://wayland.freedesktop.org/libinput/doc/)

## Downloads
Source tarballs are available <http://www.freedesktop.org/software/libinput/>

## Development
See the [Documentation](http://wayland.freedesktop.org/libinput/doc/latest/)
for details.

## Reporting Bugs
libinput bugs are tracked in the [freedesktop.org gitlab instance](https://gitlab.freedesktop.org/libinput/libinput/issues)

* [File a new bug](https://gitlab.freedesktop.org/libinput/libinput/issues/new)
* [list of open libinput bugs](https://gitlab.freedesktop.org/libinput/libinput/issues/)

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](http://wayland.freedesktop.org/libinput/doc/latest/reporting-bugs.html)
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](http://cgit.freedesktop.org/xorg/driver/xf86-input-libinput/tree/conf/99-libinput.conf) in /etc/X11/xorg.conf.d/. Restart X and the libinput driver will take over your devices.

* [http://cgit.freedesktop.org/xorg/driver/xf86-input-libinput/](http://cgit.freedesktop.org/xorg/driver/xf86-input-libinput/)