# &app; Manual V&manrevision;

## Introduction

&app; is a tool designed to help setting configuration values for the X Synaptics touchpad driver.

It helps configure the X synaptics touchpad driver parameters without editing X configuration files, through the use of the `synclient` tool in the backend.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Desktop menu

- Choose Preferences Touchpad (this location may vary across systems).

Command line

- To start &app; from a command line, type the following command, then press Return:

  `gsynaptics`

### To save your settings

To use the values you have set at each start of your Gnome session, you have to run `gsynaptics-init` on session start.

Choose Desktop menu, Preferences Sessions (this location may vary across systems).

Then in Startup Programs, you have to add `gsynaptics-init`.

## X server configuration requirements

This tool can be used only if the synaptics driver is used by the X server.

Also, it will only be able to communicate with the driver, if the `synclient` tool is installed and operational, which means there is

"SHMConfig" "true"

in the section of the synaptics driver in `xorg.conf` or `XF86Config`.

Example:

    Section "InputDevice"
            Identifier      "Synaptics Touchpad"
            Driver          "synaptics"
            Option          "SendCoreEvents"        "true"
            Option          "Device"                "/dev/psaux"
            Option          "Protocol"              "auto-dev"
            Option          "HorizScrollDelta"      "0"
            Option          "SHMConfig"             "true"
    EndSection

## Setting preferences

To configure &app;, choose Preferences Touchpad (this location may vary across systems).

The Preferences dialog contains the following tabbed sections:

- General

- Tapping

- Scrolling

### General

Enable touchpad

- If this option is enabled, the touchpad will be active.

  Sensitivity

- This will set the sensitivity level (from low to high). This represents the sensitivity of the touchpad to react to pressure.

  Depending on the actual sensitivity of your touchpad device, you may need to fine-tune this setting so that short pressure taps can be detected properly.

### Tapping

Enable tapping

- If this option is enabled, tapping the touchpad can be used to make clicks at the cursor position.

  Tapping time

- This will set the sensitivity of taps/clicks detection as a function of the length of the period during which the finger will stay in contact to the touchpad.

Enable faster tapping

- Makes the driver react faster to a single tap, but also makes double clicks caused by double tapping slower . (borrowed from `man 5 synaptics` for

  FastTaps

  configuration value of the driver)

### Scrolling

Scrolling

- The touchpad can be used to control scrolling, as could be done with a scroll-wheel mouse.

- Enable vertical scrolling

- If this option is enabled, vertical scrolling (emulating a scroll mouse) is possible when moving the finger along the right side of the touchpad.

- The scrolling speed can be set here.

Enable horizontal scrolling

- If this option is enabled, horizontal scrolling is possible when moving the finger along the bottom side of the touchpad.

- The scrolling speed can be set here.

Enable Circular scrolling

- If this option is enabled, the touchpad can act as a scrolling wheel, by drawing a circle with the finger on the touchpad.

- The scrolling speed can be set here.

- The start point of the circle for circular scrolling can also be set here.

On an edge

- continue scrolling

- TBD

cursor movement

- TBD

## Advanced configuration

The &app; program won't allow you to set all possible configuration options for the synaptics driver. For more advanced configuration, please refer to the `synclient` command.

## About &app;

&app; was written by Hiroyuki Ikezoe poincare@ikezoe.net, Takuro Ashie ashie@homa.ne.jp and Ikuya Awashiro ikuya@fruitsbasket.info. To find more information about &app;, visit the GSynaptics web page.

### Reporting Bugs and Other Feedback

Bug reports and feedback should be sent to Hiroyuki Ikezoe poincare@ikezoe.net, Takuro Ashie ashie@homa.ne.jp and Ikuya Awashiro ikuya@fruitsbasket.info.