Table of Contents

Name

xinput - utility to configure and test X input devices

Synopsis

xinput [OPTIONS] [DEVICE]

Description

xinput is a utility to list available input devices, query information about a device and change input device settings.

Options

--version
Test if the X Input extension is available and return the version number of the program and the version supported by the server. This option does not require a device name.

--list [--short || --long] [device]
If no argument is given list all the input devices. If an argument is given, show all the features of device. Uses XListInputDevices(3) . If --long is provided, the output includes detailed information about the capabilities of each devices. Otherwise, or if --short is provided, only the device names and some minimal information is listed.

--get-feedbacks device
Display the feedbacks of device.

--set-pointer device
Switch device in core pointer. This option does nothing on X servers 1.5 and later.

--set-mode device ABSOLUTE|RELATIVE
Change the mode of device.

--set-ptr-feedback device threshold num denom
Change the acceleration of device.

--set-integer-feedback device index value
Change the value of an integer feedback of device.

--set-button-map device map_button_1 [map_button_2 [...]]
Change the button mapping of device. The buttons are specified in physical order (starting with button 1) and are mapped to the logical button provided. 0 disables a button. The default button mapping for a device is 1 2 3 4 5 6 etc.

--query-state device
Query the device state.

--list-props device [device [...]]
Lists properties that can be set for the given device(s).

--set-int-prop device property format value
Sets an integer property for the device. Appropriate values for format are 8, 16, or 32, depending on the property. Deprecated, use --set-prop instead.

--set-float-prop device property value
Sets a float property for the device. Deprecated, use --set-prop instead.

--set-prop [--type=atom|float|int] [--format=8|16|32] device property value [...]
Set the property to the given value(s). If not specified, the format and type of the property are left as-is. The arguments are interpreted according to the property type.

--watch-props device
Prints to standard out when property changes occur.

--delete-prop device property
Delete the property from the device.

--test [-proximity] device
Register all extended events from device and enter an endless loop displaying events received. If the -proximity is given, ProximityIn and ProximityOut are registered.

--test_xi2
Register for a number of XI2 events and display them. This option does not take a device argument.

device can be the device name as a string or the XID of the device.

property can be the property as a string or the Atom value.

Copyright

Copyright 1996,1997, Frederic Lepied.

Copyright 2008, Philip Langdale.

Authors


Philip Langdale, <philipl@alumni.utexas.net>
Frederic Lepied, France <Frederic.Lepied@sugix.frmug.org>
Peter Hutterer <peter.hutterer@who-t.net>
Julien Cristau <jcristau@debian.org>
Thomas Jaeger <ThJaeger@gmail.com>
and more.


Table of Contents