---
name: "tpconfig"
section: "1"
platform: "linux"
package: "tpconfig"
version: "3.1.3-15"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/tpconfig"
---

# tpconfig(1)

Configure touchpad devices

## NAME

tpconfig - Configure touchpad devices

## SYNOPSIS

**tpconfig** \[ *OPTIONS* \]\
\

## DESCRIPTION

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

## AUTHORS

Bruce Kall \<kall@compass.com\>