Gebaar

Forked from Coffee2CodeNL/gebaar-libinput since original repo unmaintained for half a year, yet this is NOT OFFICIAL repo!

WM Independent Touchpad Gesture Daemon for libinput

Gebaar means Gesture in Dutch

Run any command by simply gesturing on your touchpad!

What makes this different over the other implementations?

libinput-gestures and fusuma both parse the output of the shell command libinput debug-events which is an unstable API and the output just keeps coming, so it'll eat (some) RAM.

Gebaar directly interfaces with libinput to receive and react to the events.
This is more stable, faster, and more efficient as it does not parse the output of a program like the aforementioned projects do.

Getting support (or talking about the project's future)

Click to join:

How to build and install

1. Clone the repository via git clone https://github.com/Coffee2CodeNL/gebaar-libinput
2. Check out the latest version (git checkout v0.0.5)
3. Run git submodule update --init in the root folder
4. Run mkdir build && cd build
5. Run cmake ..
6. Run make -j$(nproc)
7. Run sudo make install to install
8. Run mkdir -p ~/.config/gebaar
9. Run nano ~/.config/gebaar/gebaard.toml (or vim, if you like it better)
10. Add the snippet below to gebaard.toml
11. Configure commands to run per direction
12. Add yourself to the input group with usermod -a -G input $USER
13. Run Gebaar via some startup file by adding gebaard -b to it
14. Reboot and see the magic

[[swipe.commands]]
fingers = 3
left_up = ""
right_up = ""
up = ""
left_down = ""
right_down = ""
down = ""
left = ""
right = ""

[[swipe.commands]]
fingers = 4
left_up = ""
right_up = ""
up = ""
left_down = ""
right_down = ""
down = ""
left = ""
right = ""

[[swipe.commands]]
fingers = 1
left_up = ""
right_up = ""
up = ""
left_down = ""
right_down = ""
down = ""
left = ""
right = ""

[pinch.commands]
in = ""
out = ""

[pinch.settings]
threshold = 0.25
one_shot = false


[gesture_swipe.settings]
threshold = 0.5
one_shot = true
trigger_on_release = false

[touch_swipe.settings]
longswipe_screen_percentage = 95

• pinch.settings.threshold key sets the distance between fingers where it shold trigger. Defaults to 0.25 which means fingers should travel exactly 25% distance from their initial position.
• gesture_swipe.settings.threshold sets the limit when swipe gesture should be executed. Defaults to 0.5.
• touch_swipe.settings.longswipe_screen_percentage percentage of a screen dimension a swipe must cover to be interpreted as a longswipe. Only for 'fingers = 1'. (70% by default)

Repository versions

Examples

bspwm

~/.config/gebaar/gebaard.toml

[[swipe.commands]]
fingers = 3
left_up = ""
right_up = ""
up = "bspc node -f north"
left_down = ""
right_down = ""
down = "bspc node -f south"
left = "bspc node -f west"
right = "bspc node -f east"

[[swipe.commands]]
fingers = 4
left_up = ""
right_up = ""
up = "rofi -show combi"
left_down = ""
right_down = ""
down = ""
left = "bspc desktop -f prev"
right = "bspc desktop -f next"

[[swipe.commands]]
fingers = 1
left_up = ""
right_up = ""
up = ""
left_down = ""
right_down = ""
down = "echo long_swipe_down"
left = ""
right = ""

[pinch.commands.two]
in = "xdotool key Control_L+equal"
out = "xdotool key Control_L+minus"

[pinch.settings]
threshold=0.25
one_shot=false

[gesture_swipe.settings]
threshold = 0.5
one_shot = true
trigger_on_release = false

[touch_swipe.settings]
longswipe_screen_percentage = 95

Add gebaard -b to ~/.config/bspwm/bspwmrc

State of the project

• Receiving swipe events from libinput
• Swipe gesture have trigger treshold
• Receiving pinch/zoom events from libinput
• Support continous pinch
• Support pinch-and-rotate gestures
• Support touchscreen devices
• Receiving rotation events from libinput
• Converting libinput events to motions
• Running commands based on motions
• Refactor code to be up to Release standards, instead of testing-hell