# Docs

Open the Trickpad menu in the menu bar. Click Edit Settings… to open the file, or click Manage with Agent to open it with an installed agent. The settings live in ~/.config/trickpad/config.toml, an easy-to-edit text file.

## Gesture reference

Add a gesture name to [MOUSE] or [TRACKPAD]. Use an application section for a different binding in one app.

### Magic Mouse and trackpads

- `hold-left-tap-right`: Hold one finger still, then tap another to its right
- `hold-right-tap-left`: Hold one finger still, then tap another to its left
- `two-finger-tap`: Tap with two fingers at the same time.
- `three-finger-tap`: Tap with three fingers at the same time.
- `three-finger-swipe-left`: Swipe left with three fingers.
- `three-finger-swipe-right`: Swipe right with three fingers.
- `three-finger-swipe-up`: Swipe up with three fingers.
- `three-finger-swipe-down`: Swipe down with three fingers.

### Magic Mouse additions

- `one-finger-tap`: Tap with one finger.
- `front-right-tap`: Tap the front-right area of the mouse.
- `one-finger-swipe-left`: Swipe left with one finger.
- `one-finger-swipe-right`: Swipe right with one finger.
- `two-finger-swipe-left`: Swipe left with two fingers.
- `two-finger-swipe-right`: Swipe right with two fingers.

### Built-in and Magic Trackpad additions

- `hold-slide`: Hold one finger still while sliding another.
- `four-finger-tap`: Tap with four fingers at the same time.
- `five-finger-tap`: Tap with five fingers at the same time.
- `three-finger-click`: Click with three fingers.
- `four-finger-click`: Click with four fingers.
- `four-finger-swipe-left`: Swipe left with four fingers.
- `four-finger-swipe-right`: Swipe right with four fingers.
- `four-finger-swipe-up`: Swipe up with four fingers.
- `four-finger-swipe-down`: Swipe down with four fingers.

## Configuration file

Each device section maps a gesture name to an action.

Edit the file yourself. You can also ask an installed agent to choose a gesture and write the binding.

```toml
[GENERAL]
config-version = 3
haptic-feedback = true

[MOUSE]
hold-left-tap-right = "return"
hold-right-tap-left = "escape"
two-finger-tap = { action = "middle-click", defer = true }

[TRACKPAD]
hold-left-tap-right = "return"
hold-right-tap-left = "escape"
```

From Trickpad’s menu, you can see your current gestures, edit or reload settings, or open the file with an installed agent.

[Read the product page](/trickpad/) for examples and FAQs.