Table of Contents


xinput - utility to configure and test X input devices




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


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.

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 1996,1997, Frederic Lepied.

Copyright 2008, Philip Langdale.


Philip Langdale, <>
Frederic Lepied, France <>
Peter Hutterer <>
Julien Cristau <>
Thomas Jaeger <>
and more.

Table of Contents