From ArchWiki
Jump to navigation Jump to search

Touchegg is a multitouch gesture program, that runs as a user in the background, recognizes gestures, translates them to more conventional types of events and/or performs custom actions in response to them.

Touchegg is not compatible with Wayland.


Install toucheggAUR package. Alternatively, it is also available at touchegg-gitAUR. A qt5 version can be found at touchegg-qt5AUR[broken link: package not found]

Touchegg comes with its own minimal GUI, but you can also install touchegg-gce-gitAUR - Touchegg-GCE (GUI configuration editor).


The user configuration file is found in ~/.config/touchegg/touchegg.conf.

It is a basic XML file that defines various gestures. Please note that at this time TAP_AND_HOLD, PINCH, and ROTATE, do not appear to work.

The list of triggers can be found here.

The list of actions can be found here.

A default configuration can be found in /usr/share/touchegg/touchegg.conf.

The two-fingers scrolling emulation has been droped, due to bad user experience, in the recent 2.0 rewrite of touchegg. To restore it, install xdotool, and add the following to the configuration file :

   <gesture type="SWIPE" fingers="2" direction="DOWN">
     <action type="RUN_COMMAND">
       <command>xdotool click 4</command>
       <decreaseCommand>xdotool click 5</decreaseCommand>
   <gesture type="SWIPE" fingers="2" direction="UP">
     <action type="RUN_COMMAND">
       <command>xdotool click 5</command>
       <decreaseCommand>xdotool click 4</decreaseCommand>

Note that on Kde, text gets selected while scrolling (see).

Start on login

The daemon is started with systemd : systemctl enable touchegg.service The client can be loaded from the wm.

For gnome

  1. Hit alt-f2;
  2. Type gnome-session-properties;
  3. Hit add;
  4. In the box labeled "Command" type touchegg. Fill in "Name" and "Label" as you choose;
  5. Hit OK.
Note: gnome-session-properties has been removed from gnome 3.12. Currently, you can install gnome-session-propertiesAUR from the AUR. See more details in the BBS thread

For the startx command

You can modify your .xprofile:

touchegg &