在以下平台关注 Touchégg... <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=FT2KS37PVG8PU&currency_code=EUR&source=url"><img align="right" src="https://yellow-cdn.veclightyear.com/0a4dffa0/5c6d187c-d08c-4f02-81dc-e1b142e276a7.gif"></a>

Touchégg

Touchégg 是一个在后台运行的应用程序，可以将你在触摸板或触摸屏上做出的手势转换为桌面上的可见操作。

例如，你可以用 3 根手指向上滑动来最大化窗口，或者用 4 根手指向左滑动来切换到下一个桌面。

还有更多可用的操作和手势，而且所有设置都很容易配置。

<p align="center"> <a href="https://youtu.be/PLsH-XPFuN4">:movie_camera: Ubuntu 演示</a> <br/> <a href="https://youtu.be/nuMT-MwyTXU">:movie_camera: elementary OS 演示</a> <br/> <a href="https://www.youtube.com/watch?v=7gKONPKNZlc">:movie_camera: 触摸屏演示</a> </p>

安装

在发布页面上，你可以找到适用于你的发行版的安装包。

否则，你可以按照 HACKING.md 文件中的说明自行编译源代码。

Ubuntu、Debian 及其衍生版

在 Ubuntu 上，建议使用官方 PPA来安装 Touchégg 并接收更新：

$ sudo add-apt-repository ppa:touchegg/stable
$ sudo apt update
$ sudo apt install touchegg

运行 add-apt-repository 可能会因临时服务器问题而失败；多尝试几次，应该就能成功。 PPA 使用密钥 7EA12677D47B593CE22727D4C0FCE32AF6B96252 签名，以防你需要手动安装。

如果你的操作系统不支持 PPA，请下载 .deb 包并安装。双击软件包可能会生效，否则请从终端安装：

$ cd ~/Downloads # 或切换到 deb 包所在的路径
$ sudo apt install ./touchegg_*.deb # 安装软件包

通过运行 touchegg 命令手动启动 Touchégg，或重启系统以开始使用。

elementary OS 6、Zorin OS 16、Pop!_OS 21.04+ 和 Linux Mint 21.2 默认包含了 Touchégg。

Fedora、CentOS、RHEL 及其衍生版

在 Fedora 上，Touchégg 可在官方仓库中获得：

$ dnf install touchegg
# 你可能还需要手动启动服务
$ sudo systemctl start touchegg
$ sudo systemctl enable touchegg

在 CentOS (EPEL) 上，建议使用官方 COPR来安装 Touchégg 并接收更新。

$ sudo dnf copr enable joseexposito/touchegg
$ sudo dnf install touchegg

在其他基于 RPM 的操作系统上，下载 .rpm 包并安装。双击软件包可能会生效，否则请从终端安装：

$ cd ~/Downloads # 或切换到 rpm 包所在的路径
$ sudo dnf install touchegg-*.rpm # 安装软件包

通过运行 touchegg 命令手动启动 Touchégg，或重启系统以开始使用。

Arch Linux、Manjaro 及其衍生版

从 Arch Linux 软件包注册表安装 touchegg 软件包。

请注意，在 Arch 上，服务默认不会被启用或启动，所以你需要手动执行：

$ sudo systemctl enable touchegg.service
$ sudo systemctl start touchegg

服务启用后，通过运行 touchegg 命令手动启动 Touchégg，或重启系统以开始使用。

对于不支持 systemd 的基于 Arch 的发行版（如 Artix），AUR 上也提供了相应版本。

openSUSE

Touchégg 可在官方仓库中获得。

$ sudo zypper install touchegg
$ sudo systemctl enable touchegg.service
$ sudo systemctl start touchegg

如果你的发行版中包含的 Touchégg 版本太旧（v1.x），建议使用官方 COPR来安装 Touchégg 并接收更新。

Alpine Linux

在 /etc/apk/repositories 文件中取消测试仓库 URL 的注释，然后安装：

$ sudo apk update
$ sudo apk add touchegg

Touchégg 软件包包含一个 Openrc 初始化脚本，用于在系统启动时启动 Touchégg 守护进程。启用方法：

$ sudo rc-update add touchegg

初始化脚本也可以用于根据需要手动启动和停止 Touchégg 守护进程：

$ sudo rc-service touchegg start
$ sudo rc-service touchegg stop

Void Linux

Touchégg 可从主仓库获得。安装后需要启用其服务才能使用。

$ sudo xbps-install touchegg
$ sudo ln -s /etc/sv/touchegg /var/service

GNOME

如果你使用 GNOME 桌面环境，建议同时安装此扩展：

https://github.com/JoseExposito/gnome-shell-extension-x11gestures

Touchégg 和扩展都需要安装，所以别忘了按照你的发行版说明进行安装！

配置

安装 Touchégg 后，你会发现可以开始使用多点触控手势。不过，你不必强制使用预设的手势和操作，你可以配置你想使用的手势以及它们触发的操作。

使用 Touché

Touché 是一个桌面应用程序，可以轻松配置你的触摸板和触摸屏的多点触控手势。

GNOME 上的 Touché

</div>

按照项目页面的说明进行安装。

手动配置

Touché 是配置手势的推荐方式。但你也可以通过编辑 XML 文件手动配置 Touchégg。

首先，将默认配置从 /usr/share/touchegg/touchegg.conf 复制到 ~/.config/touchegg/touchegg.conf。你可以使用文件管理器或在终端中运行以下命令：

$ mkdir -p ~/.config/touchegg && cp -n /usr/share/touchegg/touchegg.conf ~/.config/touchegg/touchegg.conf

现在用你喜欢的文本编辑器打开 ~/.config/touchegg/touchegg.conf。这是一个包含 3 个主要部分的 XML 文档：

全局设置
全局手势：<application name="All">...</application>
特定应用程序的手势：<application name="Google-chrome,Firefox"></application>

可以通过运行以下命令并点击目标应用程序窗口获取应用程序名称：
```
$ xprop | grep WM_CLASS
```

在下面的部分中可以找到更多信息。

全局设置

选项	值	默认值	描述	示例
animation_delay	数字	150	手势开始到显示动画的延迟（毫秒）	使用 MAXIMIZE_RESTORE_WINDOW 操作。你会注意到如果动作完成得够快，就不会显示动画。此属性配置该时间
action_execute_threshold	数字	20	执行操作所需完成的手势百分比。设为 0 则无条件执行操作	使用 MAXIMIZE_RESTORE_WINDOW 操作。你会注意到，即使显示了动画，如果手指移动得不够远，操作也不会执行。此属性配置必须达到的手势百分比才能执行操作
color	十六进制颜色	3E9FED	动画的颜色	`#909090`
borderColor	十六进制颜色	3E9FED	动画的边框颜色	`FFFFFF`

可用手势

滑动

根据 libinput 文档：当三个或更多手指同步向同一方向移动时执行滑动手势。

注意，在触摸板上，Touchégg 允许滑动手势的最少手指数为三个，在触摸屏上为两个。

示例：

<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="MAXIMIZE_RESTORE_WINDOW">
    <animate>true</animate>
  </action>
</gesture>

捏合

根据 libinput 文档：当两个或更多手指放在触摸板上并改变它们之间的相对距离（捏合）或改变相对角度（旋转）时执行捏合手势。

示例：

<gesture type="PINCH" fingers="4" direction="IN">
  <action type="CLOSE_WINDOW">
    <animate>true</animate>
    <color>F84A53</color>
    <borderColor>F84A53</borderColor>
  </action>
</gesture>

轻触

当两个或更多手指在触摸屏上"点击"时执行轻触手势。

仅在触摸屏上可用

示例：

<gesture type="TAP" fingers="2">
  <action type="MOUSE_CLICK">
    <button>3</button>
    <on>begin</on>
  </action>
</gesture>

可用操作

最大化或还原窗口（MAXIMIZE_RESTORE_WINDOW）

最大化指针下的窗口。如果已经最大化，则还原它。

选项：

选项	值	描述
animate	`true`/`false`	设为 `true` 显示动画，`false` 则不显示
color	十六进制颜色	动画的颜色。例如：`909090`
borderColor	十六进制颜色	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="MAXIMIZE_RESTORE_WINDOW">
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

最小化窗口（MINIMIZE_WINDOW）

最小化指针下的窗口。

选项：

选项	值	描述
animate	`true`/`false`	设为 `true` 显示动画，`false` 则不显示
color	十六进制颜色	动画的颜色。例如：`909090`
borderColor	十六进制颜色	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="3" direction="DOWN">
  <action type="MINIMIZE_WINDOW">
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

平铺/贴靠窗口（TILE_WINDOW）

调整指针下窗口的大小并移动，使其占用屏幕的一半。

选项：

选项	值	描述
direction	`left`/`right`	使用屏幕的左半部分或右半部分
animate	`true`/`false`	设置为`true`以显示动画效果。否则设置为`false`
color	十六进制颜色值	动画的颜色。例如：`909090`
borderColor	十六进制颜色值	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="3" direction="LEFT">
  <action type="TILE_WINDOW">
    <direction>left</direction>
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

<gesture type="SWIPE" fingers="3" direction="RIGHT">
  <action type="TILE_WINDOW">
    <direction>right</direction>
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

全屏窗口 (FULLSCREEN_WINDOW)

切换指针下窗口的全屏模式。

选项：

选项	值	描述
animate	`true`/`false`	设置为`true`以显示动画效果。否则设置为`false`
color	十六进制颜色值	动画的颜色。例如：`909090`
borderColor	十六进制颜色值	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="FULLSCREEN_WINDOW">
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

关闭窗口 (CLOSE_WINDOW)

关闭指针下的窗口。

选项：

选项	值	描述
animate	`true`/`false`	设置为`true`以显示动画效果。否则设置为`false`
color	十六进制颜色值	动画的颜色。例如：`909090`
borderColor	十六进制颜色值	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="PINCH" fingers="4" direction="IN">
  <action type="CLOSE_WINDOW">
    <animate>true</animate>
    <color>F84A53</color>
    <borderColor>F84A53</borderColor>
  </action>
</gesture>

切换桌面/工作区 (CHANGE_DESKTOP)

切换到另一个桌面/工作区。

选项：

选项	值	描述
direction	`previous`/`next`/`up`/`down`/`left`/`right`/`auto`	要切换到的桌面/工作区。建议使用`previous`/`next`以获得更好的兼容性。但是，某些桌面环境（如KDE）允许配置桌面网格，此时`up`/`down`/`left`/`right`会很方便。对于`SWIPE`手势，`auto`将根据您的自然滚动偏好来确定方向。
cyclic	`true`/`false`	在使用`previous`/`next`方向时，设置为`true`可以从最后一个桌面导航到第一个桌面，或从第一个导航到最后一个。
animate	`true`/`false`	设置为`true`以显示动画效果。否则设置为`false`
animationPosition	`up`/`down`/`left`/`right`/`auto`	动画显示的屏幕边缘。对于`SWIPE`手势，`auto`将根据您的自然滚动偏好来确定动画位置。
color	十六进制颜色值	动画的颜色。例如：`909090`
borderColor	十六进制颜色值	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="4" direction="LEFT">
  <action type="CHANGE_DESKTOP">
    <direction>next</direction>
    <animate>true</animate>
    <animationPosition>right</animationPosition>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

<gesture type="SWIPE" fingers="4" direction="RIGHT">
  <action type="CHANGE_DESKTOP">
    <direction>previous</direction>
    <animate>true</animate>
    <animationPosition>left</animationPosition>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

显示桌面 (SHOW_DESKTOP)

显示桌面。如果已经显示桌面，则恢复所有窗口。

选项：

选项	值	描述
animate	`true`/`false`	设置为`true`以显示动画效果。否则设置为`false`
color	十六进制颜色值	动画的颜色。例如：`909090`
borderColor	十六进制颜色值	动画的边框颜色。例如：`#FFFFFF`

示例：

<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="SHOW_DESKTOP">
    <animate>true</animate>
    <color>909090</color>
    <borderColor>FFFFFF</borderColor>
  </action>
</gesture>

键盘快捷键 (SEND_KEYS)

模拟键盘快捷键。

选项：

选项	值	描述
repeat	`true`/`false`	是否多次执行键盘快捷键(默认:`false`)。这对于执行诸如捏合缩放等操作很有用。
modifiers	键符号	典型值包括: `Shift_L`, `Control_L`, `Alt_L`, `Alt_R`, `Meta_L`, `Super_L`, `Hyper_L`。可以使用多个键符号: `Control_L+Alt_L`。更多信息请参见下方的"键符号"部分。
keys	键符号	快捷键。可以使用多个键符号: `A+B+C`。更多信息请参见下方的"键符号"部分。
on	`begin`/`end`	仅当`repeat`为`false`时使用。是在手势开始还是结束时执行快捷键。
decreaseKeys	键符号	仅当`repeat`为`true`时使用。当手势方向改变为相反方向时要按下的键。可以使用多个键符号: `A+B+C`。这对于执行诸如捏合缩放等操作很有用,请查看下方的`示例2`。
times	2...15	仅当`repeat`为`true`时使用。重复执行动作的次数。
animate	`true`/`false`	设为`true`以显示在`animation`中设置的动画。否则为`false`。
color	十六进制颜色	动画的颜色。例如: `909090`
borderColor	十六进制颜色	动画的边框颜色。例如: `#FFFFFF`
animation	动画	参见自定义动画

键符号:

键符号可以在两个地方找到:

常规键位于/usr/include/X11/keysymdef.h中,你可以用你喜欢的文本编辑器打开它。

重要的是要移除XK_前缀。例如,超级键的键符号定义为XK_Super_L,但在配置中必须使用Super_L。
特殊键(如媒体键、浏览器后退、睡眠等)位于/usr/include/X11/XF86keysym.h中。

同样,移除XK_,但保留其余部分(包括XK_之前的部分)。例如,XF86XK_Back变成XF86Back。

请注意,只有映射到键码的键符号才能被Touchégg使用。你可以使用xmodmap -pk显示当前映射。要添加默认未映射的键符号(例如XF86ZoomIn),你可以告诉xmodmap将其映射到任何空闲的键码:

xmodmap -e 'keycode any=XF86ZoomIn'

示例1: 捏合缩放示例

<gesture type="PINCH" fingers="2" direction="IN">
  <action type="SEND_KEYS">
    <repeat>true</repeat>
    <modifiers>Control_L</modifiers>
    <keys>KP_Subtract</keys>
    <decreaseKeys>KP_Add</decreaseKeys>
  </action>
</gesture>

<gesture type="PINCH" fingers="2" direction="OUT">
  <action type="SEND_KEYS">
    <repeat>true</repeat>
    <modifiers>Control_L</modifiers>
    <keys>KP_Add</keys>
    <decreaseKeys>KP_Subtract</decreaseKeys>
  </action>
</gesture>

示例2: 在窗口间切换(Alt+Tab)

<gesture type="SWIPE" fingers="3" direction="LEFT">
  <action type="SEND_KEYS">
    <repeat>true</repeat>
    <modifiers>Alt_L</modifiers>
    <keys>Shift_L+Tab</keys>
    <decreaseKeys>Tab</decreaseKeys>
  </action>
</gesture>

<gesture type="SWIPE" fingers="3" direction="RIGHT">
  <action type="SEND_KEYS">
    <repeat>true</repeat>
    <modifiers>Alt_L</modifiers>
    <keys>Tab</keys>
    <decreaseKeys>Shift_L+Tab</decreaseKeys>
  </action>
</gesture>

示例3: 打开Gnome应用启动器

<gesture type="PINCH" fingers="4" direction="IN">
  <action type="SEND_KEYS">
    <repeat>false</repeat>
    <modifiers>Super_L</modifiers>
    <keys>A</keys>
    <on>begin</on>
  </action>
</gesture>

执行命令(RUN_COMMAND)

运行任何命令。

选项:

选项	值	描述
repeat	`true`/`false`	如果命令应多次执行则为`true`。否则为`false`。
command	命令	要执行的命令。
on	`begin`/`end`	仅当`repeat`为`false`时使用。命令是在手势开始还是结束时执行。
decreaseCommand	命令	仅当`repeat`为`true`时使用。当手势方向改变为相反方向时要运行的命令。查看下方的`示例2`。
times	2...15	仅当`repeat`为`true`时使用。重复执行动作的次数。
animate	`true`/`false`	设为`true`以显示在`animation`中设置的动画。否则为`false`。
color	十六进制颜色	动画的颜色。例如: `909090`
borderColor	十六进制颜色	动画的边框颜色。例如: `#FFFFFF`
animation	动画	参见自定义动画

示例1:

<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>notify-send '你好世界' "向下滑动, DEVICE_TYPE=$TOUCHEGG_DEVICE_TYPE"</command>
    <on>begin</on>
  </action>
</gesture>

示例2:

<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="RUN_COMMAND">
    <repeat>true</repeat>
    <command>notify-send '滑动方向' '向下'</command>
    <decreaseCommand>notify-send '滑动方向' '向上'</decreaseCommand>
  </action>
</gesture>

鼠标点击(MOUSE_CLICK)

模拟鼠标点击。

选项:

选项	值	描述
button	`1`/`2`/`3`/`8`/`9`	左键点击(1)、中键点击(2)、右键点击(3)、后退按钮(8)或前进按钮(9)
on	`begin`/`end`	命令是在手势开始还是结束时执行。

示例:

<gesture type="TAP" fingers="2">
  <action type="MOUSE_CLICK">
    <button>3</button>
    <on>begin</on>
  </action>
</gesture>

自定义动画

键盘快捷键动作和执行命令动作允许设置自定义动画。以下是可用的值:

动画	示例
CHANGE_DESKTOP_UP	切换桌面/工作区
CHANGE_DESKTOP_DOWN	切换桌面/工作区
CHANGE_DESKTOP_LEFT	切换桌面/工作区
CHANGE_DESKTOP_RIGHT	切换桌面/工作区
CLOSE_WINDOW	关闭窗口
MAXIMIZE_WINDOW	最大化或还原窗口
RESTORE_WINDOW	最大化或还原窗口
MINIMIZE_WINDOW	最小化窗口
SHOW_DESKTOP	显示桌面
EXIST_SHOW_DESKTOP	显示桌面
TILE_WINDOW_LEFT	平铺/贴靠窗口
TILE_WINDOW_RIGHT	平铺/贴靠窗口

守护进程配置

Touchégg 在两个不同的进程中运行，其中一个是配置在 /lib/systemd/system/touchegg.service 的 systemd 守护进程。除了 --daemon 参数外，你还可以传递两个可选参数：

选项	值	默认值	描述	示例
start_threshold	数字	根据设备特性自动计算	在手势开始之前需要在触摸板上移动的距离	将 3 根手指放在触摸板上。你会注意到在稍微移动它们之前动作不会开始。此属性配置在动作开始之前应该移动手指多少
finish_threshold	数字	根据设备特性自动计算	在触摸板上移动以达到动画 100% 的距离	使用 MAXIMIZE_RESTORE_WINDOW 动作。你会注意到需要移动手指一定距离直到动画填满整个屏幕。此属性配置需要移动手指多少

建议不要配置 start_threshold 和 finish_threshold，因为系统会为你计算最佳值。

但是，如果你的设备尺寸未知，你需要手动设置它们的值：

$ journalctl -u touchegg -b
[...]
无法获取设备的物理尺寸，回退到默认的 start_threshold 和 finish_threshold。你可以在服务文件中调整这些值：
https://github.com/JoseExposito/touchegg#daemon-configuration

推荐的值是：

start_threshold：屏幕高度的 3%（以毫米为单位）
finish_threshold：屏幕高度的 15%（以毫米为单位）

例如，如果你的屏幕高度是 100 毫米，编辑 /lib/systemd/system/touchegg.service 并设置正确的值：

ExecStart=/usr/bin/touchegg --daemon 3 15

最后，重启守护进程并确保打印了正确的值：

$ sudo systemctl daemon-reload && sudo systemctl restart touchegg

$ journalctl -u touchegg -b -f
检测到兼容设备：
  [...]
  计算 threshold 和 animation_finish_threshold。你可以在服务文件中调整这些值
  threshold: 3
  animation_finish_threshold: 15