### Install and Enable Touchegg on openSUSE

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Install the Touchegg package using zypper and then enable its service to start on boot. This is for openSUSE distributions.

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

--------------------------------

### Install Touchégg using make install

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Installs Touchégg after building from source. This command requires superuser privileges.

```bash
cd build
sudo make install
sudo systemctl daemon-reload && sudo systemctl restart touchegg # Start the daemon
touchegg # Run Touchégg
```

--------------------------------

### Build Touchégg from Source (Ubuntu/Debian)

Source: https://context7.com/joseexposito/touchegg/llms.txt

Install build dependencies for Ubuntu/Debian, clone the repository, configure with CMake, build using 'make', and install. Reload systemd and restart the service after installation.

```bash
# Install build dependencies (Ubuntu/Debian)
sudo apt-get install git build-essential cmake \
  libudev-dev libinput-dev libpugixml-dev libcairo2-dev \
  libx11-dev libxtst-dev libxrandr-dev libxi-dev \
  libglib2.0-dev libgtk-3-dev

# Clone and build
git clone https://github.com/JoseExposito/touchegg.git
cd touchegg
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

# Install
sudo make install
sudo systemctl daemon-reload && sudo systemctl restart touchegg
```

--------------------------------

### Build Touchégg from Source (Fedora/CentOS/RHEL)

Source: https://context7.com/joseexposito/touchegg/llms.txt

Install build dependencies for Fedora/CentOS/RHEL, clone the repository, configure with CMake, build using 'make', and install. Reload systemd and restart the service after installation.

```bash
# Install build dependencies (Fedora/CentOS/RHEL)
sudo dnf group install "development-tools"
sudo dnf install git gcc gcc-c++ cmake \
  libudev-devel libinput-devel pugixml-devel cairo-devel \
  libX11-devel libXtst-devel libXrandr-devel libXi-devel \
  glib2-devel gtk3-devel

# Clone and build
git clone https://github.com/JoseExposito/touchegg.git
cd touchegg
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

# Install
sudo make install
sudo systemctl daemon-reload && sudo systemctl restart touchegg
```

--------------------------------

### Enable and Start Touchegg Service on Arch Linux

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Use these commands to enable the Touchegg service to start on boot and then start it manually. This is for Arch Linux and its derivatives.

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

--------------------------------

### Install Touchégg on Fedora

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Install Touchégg from the official Fedora repository using dnf. You may need to manually start and enable the systemd service.

```bash
$ dnf install touchegg
# You may also need to manually start the service
$ sudo systemctl start touchegg
$ sudo systemctl enable touchegg
```

--------------------------------

### Install Touchégg .deb Package

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

If PPAs are not available, download the .deb package and install it from the terminal. Navigate to the download directory first.

```bash
cd ~/Downloads # Or to the path where the deb package is placed at
$ sudo apt-get install ./touchegg_*.deb # Install the package
```

--------------------------------

### Install and Enable Touchegg on Void Linux

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Install Touchegg using xbps-install and then enable its service by creating a symbolic link in /var/service. This is for Void Linux.

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

--------------------------------

### Install and Manage Touchégg Systemd Service

Source: https://github.com/joseexposito/touchegg/blob/master/installation/README.md

Commands to copy the service file, enable and start the Touchégg daemon, and monitor its status and logs.

```bash
sudo cp installation/touchegg.service /lib/systemd/system
sudo systemctl enable touchegg.service
sudo systemctl start touchegg
systemctl status touchegg
journalctl -u touchegg -b -f  # Monitor the logs since last boot
```

--------------------------------

### Build and Install Debian Package

Source: https://context7.com/joseexposito/touchegg/llms.txt

Commands to build a Debian package for Touchégg and install it on a system.

```bash
dpkg-buildpackage -rfakeroot -us -uc -tc
```

```bash
sudo apt install ../touchegg_*.deb
```

--------------------------------

### Install Touchégg on Ubuntu/Debian

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Use the official PPA to install Touchégg and receive updates. Ensure you update your package list after adding the PPA.

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

--------------------------------

### Run Touchégg Client and View Help

Source: https://context7.com/joseexposito/touchegg/llms.txt

Command to manually start the Touchégg client, which connects to the daemon and executes actions. Includes how to access the CLI flags reference.

```bash
touchegg
```

```bash
touchegg --help
```

--------------------------------

### Generate and Install Debian Package

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Creates a Debian package from the cloned Touchégg source and installs it. Run these commands from the cloned `touchegg` folder.

```bash
dpkg-buildpackage -rfakeroot -us -uc -tc
sudo apt install ../touchegg_*.deb # Install the package
touchegg # Run Touchégg
```

--------------------------------

### Start and Manage Touchégg Daemon

Source: https://context7.com/joseexposito/touchegg/llms.txt

Commands to enable, start, and check logs for the Touchégg system daemon using systemd. Also shows how to run the daemon with explicit motion thresholds.

```bash
sudo systemctl enable touchegg.service
sudo systemctl start touchegg
```

```bash
journalctl -u touchegg -b -f
```

```bash
touchegg --daemon 3 15
```

--------------------------------

### Install Touchégg .rpm Package

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

For other RPM-based systems, download the .rpm package and install it from the terminal. Navigate to the download directory first.

```bash
cd ~/Downloads # Or to the path where the rpm package is placed at
$ sudo dnf install touchegg-*.rpm # Install the package
```

--------------------------------

### Install Build Dependencies on Ubuntu/Debian

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Installs necessary packages for compiling Touchégg on Ubuntu, Debian, and derivatives. GTK is optional.

```bash
sudo apt-get install git build-essential gdb cmake debhelper \n  libudev-dev libinput-dev libpugixml-dev libcairo2-dev libx11-dev libxtst-dev libxrandr-dev libxi-dev libglib2.0-dev \n  libgtk-3-dev # GTK is optional, see "Compilation flags"
```

--------------------------------

### Install Touchegg on Alpine Linux

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Update package lists and install Touchegg on Alpine Linux. Ensure the testing repository is uncommented in /etc/apk/repositories.

```bash
$ sudo apk update
$ sudo apk add touchegg
```

--------------------------------

### Install Build Dependencies on Red Hat/Fedora/CentOS

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Installs necessary packages for compiling Touchégg on Red Hat, Fedora, CentOS, and derivatives. GTK is optional.

```bash
sudo dnf group install "development-tools"
sudo dnf install git gcc gcc-c++ gdb cmake rpm-build \n  libudev-devel libinput-devel pugixml-devel cairo-devel libX11-devel libXtst-devel libXrandr-devel libXi-devel glib2-devel \n  gtk3-devel # GTK is optional, see "Compilation flags"
```

--------------------------------

### Configure Touchegg Daemon Thresholds

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Set custom start and finish thresholds for the Touchegg daemon by passing them as arguments in the `ExecStart` command. Ensure these values are appropriate for your device's screen height.

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

--------------------------------

### Enable Touchegg Service on Alpine Linux

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Add the Touchegg init script to the Openrc runlevel to enable it to start at boot. This is for Alpine Linux.

```bash
$ sudo rc-update add touchegg
```

--------------------------------

### Configure GTK Auto Colors in XML

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Example XML configuration for Touchégg settings to use automatic colors based on the system theme. This requires GTK to be installed and the `AUTO_COLORS` CMake flag to be ON.

```xml
<settings>
  <property name="color">auto</property>
  <property name="borderColor">auto</property>
</settings>
```

--------------------------------

### Touchégg Configuration File Structure

Source: https://context7.com/joseexposito/touchegg/llms.txt

Example XML structure for the Touchégg configuration file, showing global settings and per-application gesture bindings. Includes placeholders for gesture nodes.

```xml
<touchégg>

  <settings>
    <!-- Milliseconds after gesture start before animation appears (default: 150) -->
    <property name="animation_delay">150</property>

    <!-- % of gesture distance required to trigger the action (0 = always trigger) -->
    <property name="action_execute_threshold">20</property>

    <!-- "auto" reads colors from your GTK theme; or use a hex value e.g. "3E9FED" -->
    <property name="color">auto</property>
    <property name="borderColor">auto</property>
  </settings>

  <!-- Global gestures applied to every application -->
  <application name="All">
    <!-- example gesture nodes go here -->
  </application>

  <!-- Per-application gestures (WM_CLASS values, comma-separated) -->
  <application name="Google-chrome,Chromium-browser">
    <!-- example gesture nodes go here -->
  </application>

</touchégg>
```

--------------------------------

### Manually Start and Stop Touchegg on Alpine Linux

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Use the rc-service command to manually start or stop the Touchegg daemon on Alpine Linux.

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

--------------------------------

### Generate and Install RPM Package

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Creates an RPM package for Touchégg. This involves setting up the rpmbuild directory and using `rpmbuild`.

```bash
mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
tar -czvf ~/rpmbuild/SOURCES/touchegg.tar.gz -C .. touchegg --transform s/^touchegg/touchegg-$(git describe --tags --abbrev=0)/
rpmbuild -ba rpm/touchegg.spec
sudo dnf install ~/rpmbuild/RPMS/x86_64/touchegg-?.?.?-?.x86_64.rpm
```

--------------------------------

### Enable Touchégg COPR on CentOS/RHEL

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Enable the official COPR repository for Touchégg on CentOS/RHEL systems before installing the package.

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

--------------------------------

### Install Code Style Check Dependencies on Ubuntu/Debian

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Installs clang, clang-format, clang-tidy, and python3 for code style checking on Ubuntu, Debian, and derivatives.

```bash
sudo apt-get install clang clang-format clang-tidy python3
```

--------------------------------

### Install Code Style Check Dependencies on Red Hat/Fedora/CentOS

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Installs clang, clang-tools-extra, and python3 for code style checking on Red Hat, Fedora, CentOS, and derivatives.

```bash
sudo yum install clang clang-tools-extra python3
```

--------------------------------

### Get Application WM_CLASS using xprop

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Run this command in the terminal and then click on the target application window to identify its WM_CLASS. This is useful for application-specific gesture configuration.

```bash
$ xprop | grep WM_CLASS
```

--------------------------------

### Get Window WM_CLASS

Source: https://context7.com/joseexposito/touchegg/llms.txt

Utility command to find the WM_CLASS name of a running window, which is necessary for per-application gesture targeting in the configuration.

```bash
xprop | grep WM_CLASS
```

--------------------------------

### Configure VS Code C++ Line Length Ruler

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Adds a vertical ruler at 80 characters in C++ files within Visual Studio Code to help adhere to the Google C++ Style Guide line length limit.

```json
"[cpp]": {
    "editor.rulers": [
        80
    ]
}
```

--------------------------------

### Configure SHOW_DESKTOP Action with SWIPE Gesture

Source: https://context7.com/joseexposito/touchegg/llms.txt

Use a 4-finger swipe down to show the desktop by minimizing all windows, or restore them if already shown. Animation and color can be configured.

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

--------------------------------

### Execute Command on Gesture Begin

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Use this to run a command when a gesture begins. The command will only execute once per gesture.

```xml
<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>notify-send 'Hello World' "Swipe down, DEVICE_TYPE=$TOUCHEGG_DEVICE_TYPE TOUCHEGG_GESTURE_ON=$TOUCHEGG_GESTURE_ON"</command>
    <on>begin</on>
  </action>
</gesture>
```

--------------------------------

### Switch Desktops Gesture Configuration (Next)

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configure a 4-finger swipe left gesture to switch to the next desktop. Animation and color options are available. Use 'next' for direction and 'right' for animation position.

```xml
<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>
```

--------------------------------

### Bootstrap Touchégg Configuration

Source: https://context7.com/joseexposito/touchegg/llms.txt

Commands to create the user configuration directory and copy the system default configuration file to the user's home directory.

```bash
mkdir -p ~/.config/touchegg
cp -n /usr/share/touchegg/touchegg.conf ~/.config/touchegg/touchegg.conf
```

--------------------------------

### Configure Touchegg Package on NixOS

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Add the touchegg package to your system's environment and enable the touchegg service within your configuration.nix file. This is for NixOS.

```nix
environment.systemPackages = with pkgs;
  [
  touchegg
];

services.touchegg.enable = true;
```

--------------------------------

### Configure Touchégg Daemon Path

Source: https://github.com/joseexposito/touchegg/blob/master/installation/README.md

Modify the ExecStart line in the systemd service file to point to your specific Touchégg binary path for debugging or custom builds.

```bash
ExecStart=/home/jose/Devel/touchegg/build/touchegg --daemon
```

--------------------------------

### Switch Desktops Gesture Configuration (Previous)

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configure a 4-finger swipe right gesture to switch to the previous desktop. Animation and color options are available. Use 'previous' for direction and 'left' for animation position.

```xml
<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>
```

--------------------------------

### Generate Doxygen Documentation

Source: https://context7.com/joseexposito/touchegg/llms.txt

Generate HTML documentation using Doxygen by navigating to the 'documentation' directory and running 'doxygen doxyfile'. Open the generated 'index.html' in a browser.

```bash
# Generate Doxygen HTML documentation
cd documentation && doxygen doxyfile
# Open documentation/html/index.html in a browser
```

--------------------------------

### Copy Default Touchegg Configuration

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Create the configuration directory and copy the default touchegg.conf file to the user's config directory. This prepares the file for manual editing.

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

--------------------------------

### Configure Desktop Switching with SWIPE Gestures

Source: https://context7.com/joseexposito/touchegg/llms.txt

Use SWIPE gestures to switch between desktops. Configure direction, cyclic behavior, animation, and color.

```xml
<!-- Next desktop on 4-finger swipe left; previous on swipe right -->
<gesture type="SWIPE" fingers="4" direction="LEFT">
  <action type="CHANGE_DESKTOP">
    <!-- previous | next | up | down | left | right | auto -->
    <direction>next</direction>
    <cyclic>true</cyclic>         <!-- wrap around last/first desktop -->
    <animate>true</animate>
    <!-- up | down | left | right | auto -->
    <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>
    <cyclic>true</cyclic>
    <animate>true</animate>
    <animationPosition>left</animationPosition>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>
```

--------------------------------

### Compile Touchégg using CMake

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Clones the Touchégg source code and compiles it using CMake. Ensure you are in the cloned directory.

```bash
git clone https://github.com/JoseExposito/touchegg.git
cd touchegg
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
```

--------------------------------

### Generate HTML Documentation with Doxygen

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Execute these commands to generate HTML documentation from Doxygen comments. The main entry point for the documentation is the index.html file.

```bash
cd documentation
doxygen doxyfile
```

--------------------------------

### Emulate Keyboard Shortcuts with SEND_KEYS Action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Emulate keyboard shortcuts using X11 keysyms. Supports one-shot or continuous repeat. Modifier and key names are derived from X11 headers.

```xml
<!-- One-shot: open GNOME overview on 4-finger swipe right (Super+S) -->
<gesture type="SWIPE" fingers="4" direction="RIGHT">
  <action type="SEND_KEYS">
    <repeat>false</repeat>
    <modifiers>Super_L</modifiers>
    <keys>S</keys>
    <on>begin</on>          <!-- begin | end | begin-and-end -->
  </action>
</gesture>

<!-- Repeating: pinch-to-zoom in Chrome/Chromium (Ctrl+=/Ctrl+-) -->
<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> <!-- sent when direction reverses -->
    <times>5</times>        <!-- max repetitions (2-15) -->
  </action>
</gesture>

<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>

<!-- Alt+Tab window switcher with 3-finger swipe -->
<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>

<!-- Add an unmapped keysym before using it (run once, not persistent) -->
<!-- xmodmap -e 'keycode any=XF86ZoomIn' -->
```

--------------------------------

### Emulate Mouse Clicks with MOUSE_CLICK Action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configure gestures to emulate mouse button presses. Use 'begin' for a momentary press, 'end' for a release, or 'begin-and-end' to hold the button during the gesture.

```xml
<!-- 2-finger tap → right-click (touchscreen) -->
<gesture type="TAP" fingers="2">
  <action type="MOUSE_CLICK">
    <button>3</button>
    <on>begin</on>          <!-- begin | end | begin-and-end -->
  </action>
</gesture>

<!-- 3-finger tap → middle-click (touchscreen) -->
<gesture type="TAP" fingers="3">
  <action type="MOUSE_CLICK">
    <button>2</button>
    <on>begin</on>
  </action>
</gesture>

<!-- Hold left button for drag during gesture (begin-and-end) -->
<gesture type="SWIPE" fingers="2" direction="DOWN">
  <action type="MOUSE_CLICK">
    <button>1</button>
    <on>begin-and-end</on>  <!-- button down on begin, up on end -->
  </action>
</gesture>
```

--------------------------------

### Configure FULLSCREEN_WINDOW action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configures the FULLSCREEN_WINDOW action, typically triggered by a 3-finger swipe up. Supports animation and color customization.

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

--------------------------------

### Configure TILE_WINDOW action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configures the TILE_WINDOW action for left or right tiling, typically triggered by a 3-finger swipe left or right. Supports animation and color customization.

```xml
<!-- Tile left on 3-finger swipe left -->
<gesture type="SWIPE" fingers="3" direction="LEFT">
  <action type="TILE_WINDOW">
    <direction>left</direction>   <!-- left or right -->
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

<!-- Tile right on 3-finger swipe right -->
<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>
```

--------------------------------

### Open Gnome Application Launcher

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configure a four-finger pinch gesture to open the Gnome application launcher. Set repeat to false and specify the Super_L modifier with the 'A' key.

```xml
<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>
```

--------------------------------

### Tune Touchégg Daemon Thresholds

Source: https://context7.com/joseexposito/touchegg/llms.txt

Override default 'start_threshold' and 'finish_threshold' in the systemd service file if Touchégg cannot detect device size. Apply changes with 'daemon-reload' and 'restart'.

```bash
# Check if manual tuning is needed
journalctl -u touchegg -b | grep "falling back"
# Output when needed:
# It wasn't possible to get your device physical size,
# falling back to default start_threshold and finish_threshold.

# Recommended formula:
#   start_threshold  = 3% of screen height in mm
#   finish_threshold = 15% of screen height in mm
# Example: 100 mm screen height → start=3, finish=15

# Edit the service file
sudo nano /lib/systemd/system/touchegg.service
# Change:  ExecStart=/usr/bin/touchegg --daemon
# To:      ExecStart=/usr/bin/touchegg --daemon 3 15

# Apply changes
sudo systemctl daemon-reload && sudo systemctl restart touchegg

# Verify thresholds in logs
journalctl -u touchegg -b -f
# Expected:
#   threshold: 3
#   animation_finish_threshold: 15
```

--------------------------------

### Configure MINIMIZE_WINDOW action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configures the MINIMIZE_WINDOW action, typically triggered by a 3-finger swipe down. Supports animation and color customization.

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

--------------------------------

### Configure MAXIMIZE_RESTORE_WINDOW action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configures the MAXIMIZE_RESTORE_WINDOW action, typically triggered by a 3-finger swipe up. Supports animation and color customization.

```xml
<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="MAXIMIZE_RESTORE_WINDOW">
    <animate>true</animate>       <!-- true/false -->
    <color>3E9FED</color>         <!-- hex, no # prefix -->
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>
```

--------------------------------

### Execute Shell Commands with RUN_COMMAND Action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Execute arbitrary shell commands. Environment variables TOUCHEGG_DEVICE_TYPE and TOUCHEGG_GESTURE_ON are available. Supports one-shot or repeating commands.

```xml
<!-- One-shot: send a desktop notification on gesture begin -->
<gesture type="SWIPE" fingers="4" direction="UP">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>notify-send "Gesture" "4-finger swipe up on $TOUCHEGG_DEVICE_TYPE"</command>
    <on>begin</on>          <!-- begin | end | begin-and-end -->
  </action>
</gesture>

<!-- Repeating: two commands, forward and reverse direction -->
<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="RUN_COMMAND">
    <repeat>true</repeat>
    <command>notify-send 'Direction' 'DOWN'</command>
    <decreaseCommand>notify-send 'Direction' 'UP'</decreaseCommand>
    <times>10</times>
  </action>
</gesture>

<!-- Script using TOUCHEGG_GESTURE_ON to distinguish begin vs end -->
<gesture type="TAP" fingers="2">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>
      if [ "$TOUCHEGG_GESTURE_ON" = "begin" ]; then
        notify-send "Tap started"
      else
        notify-send "Tap ended"
      fi
    </command>
    <on>begin-and-end</on>
  </action>
</gesture>

<!-- With custom animation overlay -->
<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>rofi -show drun</command>
    <on>end</on>
    <animate>true</animate>
    <animation>MAXIMIZE_WINDOW</animation>  <!-- reuse a built-in animation -->
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>
```

--------------------------------

### Check Touchegg Daemon Logs for Thresholds

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

View the Touchegg daemon logs to verify that the custom threshold values have been successfully applied. This command follows the logs in real-time.

```bash
$ journalctl -u touchegg -b -f
```

--------------------------------

### Build Touchégg without Systemd Integration

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configure the build with CMake using '-DUSE_SYSTEMD=OFF' for distributions that do not use systemd.

```bash
# Build without systemd (for distributions using OpenRC, runit, etc.)
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DUSE_SYSTEMD=OFF ..
```

--------------------------------

### View Touchegg Daemon Logs

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Check the systemd journal for logs related to the Touchegg daemon, specifically for the current boot. This can help diagnose issues or confirm configuration.

```bash
$ journalctl -u touchegg -b
```

--------------------------------

### Configure CLOSE_WINDOW action

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configures the CLOSE_WINDOW action, typically triggered by a 4-finger pinch in. Supports animation and color customization.

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

--------------------------------

### Build Touchégg without GTK Support

Source: https://context7.com/joseexposito/touchegg/llms.txt

Configure the build with CMake using '-DAUTO_COLORS=OFF' to disable GTK color support if not needed.

```bash
# Build without GTK (disables "auto" color support)
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DAUTO_COLORS=OFF ..
```

--------------------------------

### Maximize Window with Animation and Color

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configures a 3-finger swipe up gesture to maximize or restore a window, including animation and specific colors for the visual feedback.

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

--------------------------------

### Reload Systemd and Restart Touchégg

Source: https://github.com/joseexposito/touchegg/blob/master/installation/README.md

Commands to reload the systemd daemon configuration and restart the Touchégg service after making changes.

```bash
sudo systemctl daemon-reload && sudo systemctl restart touchegg
```

--------------------------------

### Configure PINCH gestures

Source: https://context7.com/joseexposito/touchegg/llms.txt

Defines actions for PINCH gestures (IN/OUT). Use for closing windows, showing the desktop, or sending key combinations.

```xml
<!-- 3-finger pinch in → close window (red animation) -->
<gesture type="PINCH" fingers="3" direction="IN">
  <action type="CLOSE_WINDOW">
    <animate>true</animate>
    <color>F84A53</color>
    <borderColor>F84A53</borderColor>
  </action>
</gesture>

<!-- 4-finger pinch out → show desktop -->
<gesture type="PINCH" fingers="4" direction="OUT">
  <action type="SHOW_DESKTOP">
    <animate>true</animate>
  </action>
</gesture>

<!-- 4-finger pinch in → open GNOME app launcher (Super+A) -->
<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>
```

--------------------------------

### Configure Tap Gesture

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Defines a 2-finger tap gesture to perform a right mouse click on begin.

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

--------------------------------

### Configure 4-finger SWIPE gestures

Source: https://context7.com/joseexposito/touchegg/llms.txt

Defines actions for 4-finger swipes. Use for switching desktops or showing the desktop.

```xml
<!-- 4-finger swipe → switch desktop/workspace with auto-direction support -->
<gesture type="SWIPE" fingers="4" direction="LEFT">
  <action type="CHANGE_DESKTOP">
    <direction>next</direction>
    <cyclic>true</cyclic>
    <animate>true</animate>
    <animationPosition>right</animationPosition>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

<!-- 4-finger swipe down → show desktop (toggle) -->
<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="SHOW_DESKTOP">
    <animate>true</animate>
    <color>909090</color>
    <borderColor>FFFFFF</borderColor>
  </action>
</gesture>
```

--------------------------------

### Custom Animation Overlay for RUN_COMMAND

Source: https://context7.com/joseexposito/touchegg/llms.txt

Display a built-in animation, like CLOSE_WINDOW, while executing a custom command. Set 'animate' to true and specify the desired 'animation' identifier.

```xml
<!-- Show a "close window" animation while running a custom command -->
<gesture type="PINCH" fingers="3" direction="IN">
  <action type="RUN_COMMAND">
    <repeat>false</repeat>
    <command>xdotool getactivewindow windowclose</command>
    <on>end</on>
    <animate>true</animate>
    <animation>CLOSE_WINDOW</animation>
    <color>F84A53</color>
    <borderColor>F84A53</borderColor>
  </action>
</gesture>

<!--
Available animation values:
  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
-->
```

--------------------------------

### Tile Window Right

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configures a 3-finger swipe right gesture to tile the window to the right half of the screen, with animation and custom colors.

```xml
<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>
```

--------------------------------

### Switch Windows Keyboard Shortcut

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Emulate Alt+Tab for switching between windows using swipe gestures. Configure repeat to true for continuous switching and define keys for forward and backward tab navigation.

```xml
<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>
```

```xml
<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>
```

--------------------------------

### Tile Window Left

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configures a 3-finger swipe left gesture to tile the window to the left half of the screen, with animation and custom colors.

```xml
<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>
```

--------------------------------

### Execute Command with Directional Decrease

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

This snippet executes a command when a gesture begins and a different command when the gesture direction is reversed. It's useful for toggling states or actions.

```xml
<gesture type="SWIPE" fingers="4" direction="DOWN">
  <action type="RUN_COMMAND">
    <repeat>true</repeat>
    <command>notify-send 'Swipe direction' 'DOWN'</command>
    <decreaseCommand>notify-send 'Swipe direction' 'UP'</decreaseCommand>
  </action>
</gesture>
```

--------------------------------

### Configure Swipe Up Gesture

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Defines a 3-finger swipe up gesture to maximize or restore a window with animation.

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

--------------------------------

### Configure 3-finger SWIPE gestures

Source: https://context7.com/joseexposito/touchegg/llms.txt

Defines actions for 3-finger swipes in different directions. Use for window management like maximizing, minimizing, or tiling.

```xml
<!-- 3-finger swipe up → maximize/restore the window under the pointer -->
<gesture type="SWIPE" fingers="3" direction="UP">
  <action type="MAXIMIZE_RESTORE_WINDOW">
    <animate>true</animate>
    <color>3E9FED</color>
    <borderColor>3E9FED</borderColor>
  </action>
</gesture>

<!-- 3-finger swipe down → minimize -->
<gesture type="SWIPE" fingers="3" direction="DOWN">
  <action type="MINIMIZE_WINDOW">
    <animate>true</animate>
  </action>
</gesture>

<!-- 3-finger swipe left/right → tile window to left/right half of screen -->
<gesture type="SWIPE" fingers="3" direction="LEFT">
  <action type="TILE_WINDOW">
    <direction>left</direction>
    <animate>true</animate>
  </action>
</gesture>
```

--------------------------------

### Configure TAP gestures

Source: https://context7.com/joseexposito/touchegg/llms.txt

Defines actions for TAP gestures on touchscreens. Use for mouse clicks (right or middle).

```xml
<!-- 2-finger tap → right-click -->
<gesture type="TAP" fingers="2">
  <action type="MOUSE_CLICK">
    <button>3</button>
    <on>begin</on>
  </action>
</gesture>

<!-- 3-finger tap → middle-click -->
<gesture type="TAP" fingers="3">
  <action type="MOUSE_CLICK">
    <button>2</button>
    <on>begin</on>
  </action>
</gesture>
```

--------------------------------

### Reload and Restart Touchegg Daemon

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

After modifying the service file, reload the systemd daemon configuration and restart the Touchegg service to apply the changes. This ensures the new threshold values are active.

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

--------------------------------

### Pinch to Zoom Keyboard Shortcut

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

Configure pinch gestures to zoom in or out using keyboard shortcuts. Set repeat to true for continuous zooming and specify keys for zoom in/out actions.

```xml
<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>
```

```xml
<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>
```

--------------------------------

### Configure VS Code to Format on Save

Source: https://github.com/joseexposito/touchegg/blob/master/HACKING.md

Enables automatic code formatting upon saving files in Visual Studio Code. This ensures consistent code style.

```json
"editor.formatOnSave": true
```

--------------------------------

### Enable Touchpad Overscroll History Navigation in Chromium

Source: https://github.com/joseexposito/touchegg/blob/master/README.md

To enable two-finger swipe navigation for browser history in Chromium-based browsers, launch the browser with this specific command-line flag. This is an alternative to Wayland for this functionality.

```bash
--enable-features=TouchpadOverscrollHistoryNavigation
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.