1xinput_calibrator(1) xinput_calibrator(1)
2
3
4
6 xinput_calibrator - A generic touchscreen calibration program for X.Org
7
8
10 xinput_calibrator [OPTIONS]
11
13 xinput_calibrator is a program for calibrating your touchscreen, when
14 using the X Window System.
15
16 It currently features:
17 - works for any standard Xorg touchscreen driver (uses XInput protocol)
18 - mis-click detection (prevents bogus calibration)
19 - dynamically recalibrates the evdev driver
20 - outputs the calibration as xorg.conf.d snippet or HAL policy file
21 - and more
22
23 see http://www.freedesktop.org/wiki/Software/xinput_calibrator
24
25
27 -h, --help
28 Print a help message listing the version and available options.
29
30 -v, --verbose
31 Print debug messages during the process.
32
33 --list List the calibratable input devices.
34
35 --device device_name_or_id
36 Select a specific device to calibrate; use --list to list the
37 calibratable input devices.
38
39 --precalib min_x max_x min_y max_y
40 Manually provide the current calibration setting.
41 This is useful if the calibration values are stored in your
42 xorg.conf, but the driver does not export them through XInput
43 (eg. the calibrator can not know these values)
44
45 --misclick nr_of_pixels
46 set the misclick threshold (0=off, default: 15 pixels)
47
48 --output-type auto|xorg.conf.d|hal|xinput
49 type of config to ouput (auto=automatically detect, default:
50 auto)
51
52 --fake Emulate a fake driver (for testing purposes)
53 Useful to test the calibrator without applying the values, and
54 possibly even without having a touchscreen.
55
57 Run xinput_calibrator in a terminal, as it prints out the calibration
58 values and instructions on standard output.
59
60 After clicking the 4 calibration points, xinput_calibrator will calcu‐
61 late the new calibration values. Depending on the Xorg touchscreen
62 driver you use, the new values can be made permanent in different ways:
63
64 Evdev:
65 Automatically recalibrates the driver for this session,
66 Supports following --output-types: auto, xorg.conf.d, hal, xinput
67
68
69 Usbtouchscreen:
70 Automatically recalibrates the *kernel module*, saved in /etc/mod‐
71 probe.conf.local
72 Supports following --output-types: auto
73
74
75 Other Xorg touchscreen drivers:
76 No automatic calibration possible,
77 Supports following --output-types: auto, xorg.conf.d, hal
78
80 To run the calibrator, type in your terminal:
81
82 xinput_calibrator
83
84 If something goes wrong, or not as expected, turn on verbose messages:
85
86 xinput_calibrator -v
87
88 If you have to manually provide the current calibration values (when
89 using EVDEV, you can use this to reset the calibration first):
90
91 xinput_calibrator --precalib 0 1000 0 1000
92
94 In general, run the calibrator with the -v option, it will tell you
95 what happens and what goes wrong.
96
97 Mis-click detection, the calibrator can automatically detect clicks
98 with unreasonable values. This prevents you from ending up with a bogus
99 calibration.
100
101 If you keep getting the message 'Mis-click detected, restarting...',
102 one of the following is happening:
103 1. you are bad at clicking on crosses, use a stylus or increase the
104 --misclick threshold
105 2. your device is not properly supported by the kernel, it interprets
106 the clicks wrong
107 3. your screen has a non-linear deformation, 4-point calibration can
108 not help you
109
111 xinput(1)
112
114 Tias Guns <tias@ulyssis.org>
115
116
117
118Tias Guns xinput_calibrator(1)