1synclient(1) synclient(1)
2
6 synclient - query and modify Synaptics TouchPad driver for XOrg/XFree86
7 server parameters on the fly.
8
10 synclient [-m interval]
11 synclient [-hlV?] [var1=value1 [var2=value2] ...]
12
14 This program lets you change your Synaptics TouchPad driver for
15 XOrg/XFree86 server parameters while X is running if you enabled SHM‐
16 Config "on" in your XOrg/XFree86 configuration.
17 WARNING: This is not secure if you are in an untrusted multiuser
19 environment. All local users can change the parameters at any
20 time.
21
23 -m interval
24 monitor changes to the touchpad state. Interval specifies how
25 often (in ms) to poll the touchpad state. Whenever a change in
26 the touchpad state is detected, one line of output is generated
27 that describes the current state of the touchpad. The following
28 data is included in the output.
29 time Time in seconds since the logging was started.
31 x,y The x/y coordinates of the finger on the touchpad. The
33 origin is in the upper left corner.
34 z The "pressure" value. Pressing the finger harder on the
36 touchpad typically produces a larger value. Note that
37 most touchpads don't measure the real pressure though.
38 Instead, capacitance is usually measured, which is corre‐
39 lated to the contact area between the finger and the
40 touchpad. Since more pressure usually means a larger
41 contact area, the reported pressure value is at least
42 indirectly related to the real pressure.
43 f The number of fingers currently touching the touchpad.
45 Note that only some touchpads can report more than one
46 finger. Generally, synaptics touchpads can, but ALPS
47 touchpads can't.
48 w The w value is a measurement of the finger width. This
50 is only supported by some synaptics touchpads. Touchpads
51 that can't measure the finger width typically report a
52 faked constant value when a finger is touching the touch‐
53 pad.
54 l,r,u,d,m,multi
56 The state of the left, right, up, down, middle and multi
57 buttons. Zero means not pressed, one means pressed. Not
58 all touchpads have all these buttons. If a button
59 doesn't exist, the value is always reported as 0.
60 gl,gm,gr
62 Some touchpads have a "guest device". This is typically
63 a pointing stick located in the middle of the keyboard.
64 Some guest devices have physical buttons, or can detect
65 button presses when tapping on the pointing stick. Such
66 button events are reported as "guest left", "guest mid‐
67 dle" or "guest right".
68 gdx,gdy
70 Pointer movements from the guest device are reported as
71 relative x/y positions, called gdx and gdy.
72 -h Show detected hardware properties.
74 -l List current user settings.
76 -V Print version number and exit.
78 -? Show the help message.
80 var=value
82 Set user parameter var to value.
83
87 /etc/X11/xorg.conf
88 /etc/X11/XF86Config-4
90
92 To disable EdgeMotionSpeed:
93 synclient EdgeMotionSpeed=0
95 To monitor touchpad events:
97 synclient -m 100
99
101 Peter Osterlund <petero2@telia.com> and many others.
102 This man page was written by Mattia Dongili <malattia@debian.org>
104
106 syndaemon(1), synaptics(5)
107 0.14.4 synclient(1)