---
name: "xinput"
section: "1x"
platform: "linux"
package: "xinput"
version: "1.2-5.3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/xinput/1x"
---

# xinput(1x)

utility to configure and test XInput devices

## NAME

xinput - utility to configure and test XInput devices

## SYNOPSIS

**xinput** \[version\] \[list \[*device\_name*\]\] \[set-pointer *device\_name*\] \[get-feedbacks *device\_name*\] \[set-mode *device\_name* *ABSOLUTE\|RELATIVE*\] \[set-ptr-feedback *device\_name* *threshold* *num* *denom*\] \[set-integer-feedback *device\_name* *index* *value*\] \[set-button-map *device\_name* *map button 1* \[*map button 2* \[*...*\]\]\] \[query-state *device\_name*\] \[test \[-proximity\] *device\_name*\]

## DESCRIPTION

- **xinput version**

  test if the XInput extension is available and return the version number of the program.

- **xinput list \[*device\_name*\]**

  If no argument is given list all the input devices showing all their features. If an argument is given, show all the feature of *device\_name*. Uses [XListInputDevices(3)](/XListInputDevices/3.md).

- **xinput get-feedbacks *device\_name***

  Display the feedbacks of *device\_name*. Uses [XGetFeedbackControl(3)](/XGetFeedbackControl/3.md).

- **xinput set-pointer *device\_name***

  Switch *device\_name* in core pointer. Uses [XChangePointerDevice(3)](/XChangePointerDevice/3.md).

- **xinput set-mode *device\_name* *ABSOLUTE\|RELATIVE***

  Change the mode of *device\_name*. Uses [XSetDeviceMode(3)](/XSetDeviceMode/3.md).

- **xinput set-ptr-feedback *device\_name* *threshold* *num* *denom***

  Change the acceleration of *device\_name*. Uses [XChangeFeedbackControl(3)](/XChangeFeedbackControl/3.md).

- **xinput set-integer-feedback *device\_name* *index* *value***

  Change the value of an integer feedback of *device\_name*. Uses [XChangeFeedbackControl(3)](/XChangeFeedbackControl/3.md).

- **xinput set-button-map *device\_name* *map button 1* \[*map button 2* \[*...*\]\]**

  Change the button mapping of *device\_name*. Uses [XSetDeviceButtonMapping(3)](/XSetDeviceButtonMapping/3.md).

- **xinput query-state *device\_name***

  Query the device state. Uses [XQueryDeviceState(3)](/XQueryDeviceState/3.md).

- **xinput test \[-proximity\] *device\_name***

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

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

## COPYRIGHT

Copyright 1996,1997, Frederic Lepied.

## AUTHOR

```
Frederic Lepied, France <Frederic.Lepied@sugix.frmug.org>
```

Patches, bug reports, and suggestions are welcome.