Multitouch Trackpad Touchpad Gestures

This guide sets up touchpad gestures with fusuma on Garuda Sway and Garuda i3.

Tested hardware

Touchpad: Apple Magic Trackpad 2

Setup

Install fusuma
Terminal window
```
paru -S ruby-fusuma
```
Install the following fusuma plugins
Terminal window
```
paru -S ruby-fusuma-plugin-tap ruby-fusuma-plugin-keypress
```
Do not install the plugin packages “ruby-fusuma-plugin-sendkey” or “ruby-fusuma-plugin-appmatcher” --- If you have them installed, remove them. They can cause errors/conflicts with the config.yml example below.
Create the directory ~/.config/fusuma
Terminal window
```
mkdir ~/.config/fusuma
```
Create a new file ~/.config/fusuma/config.yml

Edit your newly created config.yml to contain the following:

Use a text editor, place the content below into the file and save. You can adjust it with the example configs from the fusuma wiki.

The config uses swaymsg. For i3, replace each instance of swaymsg with i3-msg.

# Custom ~/.config/fusuma/config.yml for Garuda Sway Edition
#
# config.yml for fusuma --- https://github.com/iberianpig/fusuma
#
# This should work in any linux distro running sway and using fusuma.
#
# Email:
#
# Note, this is not a file included in Garuda Official.
# This is user contributed to help others along the way.
#
# swipe section
swipe:
  3:
    left:
      command: swaymsg move left # Move Window Left
    right:
      command: swaymsg move right #  Move Window Right
    up:
      command: swaymsg move up # Move Window Up
    down:
      command: swaymsg move down # Move Window Down
  4:
    left:
      command: swaymsg workspace next # Next Workspace
    right:
      command: swaymsg workspace prev # Previous Workspace
    up:
      command: swaymsg fullscreen toggle # Fullscreen Toggle
    down:
      command: swaymsg floating toggle # Tiling Floating Toggle
# pinch section
pinch:
  2:
    in:
      command: "xdotool keydown ctrl click 4 keyup ctrl" # Zoom In - Test in a browser
    out:
      command: "xdotool keydown ctrl click 5 keyup ctrl" # Zoom Out - Test in a browser
  4:
    in:
      command:
        "xdotool key super+a" # Window Overview - Mod+a not defined in sway
        # Redefine to something useful
    out:
      command:
        "xdotool key super+s" # Workspace Overview - Mod+s not defined in sway
        # Redefine to something useful
threshold:
  swipe: 0.4
  pinch: 0.4

interval:
  swipe: 0.8
  pinch: 0.1

More config.yml Examples

Start fusuma in terminal by simply typing the command fusuma
Terminal window
```
fusuma
```
Start fusuma in a terminal, not daemonized, for initial testing. fusuma should now be running in your terminal.
Test

Try some gestures on your trackpad or touchpad.

You can see which gestures are defined in the ~/.config/fusuma/config.yml that you just created.

Try 3-finger-swipe up/down/left/right, for example.

You can watch the terminal output from fusuma (in the terminal you started fusuma in) as you are swiping/pinching. This is handy for troubleshooting.
Set up fusuma daemonized so it runs automatically when you log in

Fusuma is running in a terminal for testing right now. Press Control + C to stop it. Now make it run in the background each time you log in.

Use the Sway/i3 autostart procedure to run the fusuma -d daemon in the background with each login.

Conclusion

Fusuma is reliable and works across window managers.

A video by another user on Odysee setting up fusuma