tpconfig1

Usage

Overview

This program can show or modify the configuration of several different kinds of touchpad devices, including most Synaptics TouchPad devices and the ALPS Glidepad/Stickpointer.

Options for all touchpads:

--help

Display a help summary and exit.

-D [N], --debug[=N]

Generate debugging output, where N of 1, 2, or 3 specifies the debugging level. If N is 0, debugging is turned off. If N is not given, it defaults to 1.

-d DEVICE, --device=DEVICE

Use DEVICE as the device file for the mouse. If this option isn't given, the device file /dev/psaux is used.

--version

Display the version and copyright information and exit.

-i, --info

Display the current touchpad configuration.

-x, --reset

Perform a software reset on the touchpad.

Options for all Synaptics TouchPads:

-q, --quiet, --silent

Suppress verbose output.

-a [N]

Display the packet mode. With argument N, set the packet mode, where N=0 means relative and N=1 means absolute.

--absolute

Set the packet mode to absolute.

--relative

Set the packet mode to relative.

-r [N], --rate[=N]

Display the reporting rate. With argument N, set the reporting rate, where N=0 means normal, and N=1 means high.

Options for older Synaptics TouchPads only:

-t [N], --tapmode[=N]

Display the tapping mode. With argument N, set the tapping mode, where N=0 means no tap gestures, and N=1 means tap and drag.

-s [N], --sleep[=N]

Display the sleep mode. With argument N, set the sleep mode, where N=0 means disable, and N=1 means enable.

Options for newer Synaptics TouchPads only:

-t [N], --tapmode[=N]

Display the tapping mode. With argument N, set the tapping mode, where N=0 means no tap gestures, N=1 means tap-to-click only, N=2 means tap and non-locking drag, and N=3 means tap and locking drag.

-2, --two-button

Set two-button mode.

-3, --three-button

Set three-button mode.

-c [N], --corner[=N]

Display the corner-tap mode. With argument N, set the corner-tap mode, where N=0 means disable, and N=1 means enable.

-e [N], --edgemode[=N]

Display edge motion. With argument N, set edge motion, where N=0 means never, N=1 means always, and N=3 means only during drag.

-m

Display which mouse button is simulated by corner taps.

--middle-button

Make corner taps simulate the middle mouse button.

--right-button

Make corner taps simulate the right mouse button.

-z [N], --zthreshold[=N]

Display the z threshold setting (tap sensitivity). With argument N, set the z threshold setting to N.

--threshold[=N]

(Same as --zthreshold.)

Options for ALPS touchpads:

-r, --reset

Reset ALPS device.

-t [N], --tapmode[=N]

Display the tapping mode. With argument N, set the tapping mode, where N=0 means tapping disabled, and N=1 means tapping enabled.

Examples

Often it's desirable to disable tap mode, to prevent mouse events from being generated when the hand brushes the touchpad:

tpconfig --tapmode=0