summaryrefslogtreecommitdiff
path: root/Software/libinput.mdwn
blob: bd61aa231dc878c4ea0c1cc5c19edfd99d0e005c (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
# 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 high-level information, documentation about libinput's API and examples are available in the [API documentation](http://wayland.freedesktop.org/libinput/doc/latest/).

## 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)
### 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
* git://anongit.freedesktop.org/git/wayland/libinput
* ssh://git.freedesktop.org/git/wayland/libinput

## cgit Web Frontend
* <http://cgit.freedesktop.org/wayland/libinput>

## Documentation
* [API documentation (development branch)](http://wayland.freedesktop.org/libinput/doc/latest/modules.html)
* [API documentation (releases)](http://wayland.freedesktop.org/libinput/doc/)
* [[Info for libinput developers|/Software/libinput/developers]]

### Feature-specific documentation

Feature-specific documentation is available in the [Related Pages](http://wayland.freedesktop.org/libinput/doc/latest/pages.html) section of the API documentation.

A note on [[feature requests|/Software/libinput/feature requests]]

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

## Development
Development and discusssion of libinput happens on the [wayland-devel@lists.freedesktop.org](http://lists.freedesktop.org/mailman/listinfo/wayland-devel) mailing list.
Please submit patches to this list as well.

## Reporting Bugs
libinput has a bugzilla component under the Wayland product [freedesktop.org Bugzilla](https://bugs.freedesktop.org/enter_bug.cgi?product=wayland&component=libinput)

* [File a new bug](https://bugs.freedesktop.org/enter_bug.cgi?product=wayland&component=libinput)
* [list of open libinput bugs](https://bugs.freedesktop.org/buglist.cgi?component=libinput&product=Wayland&resolution=---)

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/)