libinput-gestures-scripts/README.md

libinput-gestures Configuration Scripts

This repository contains custom scripts for configuring and managing gestures using libinput-gestures. These scripts are designed to add productivity-enhancing gesture controls for your Linux desktop environment.

📋 Prerequisites

Before using these scripts, ensure you have the following dependencies installed:

• libinput
• libinput-gestures
• xdotool
• skippy-xd (for window management)

Install Dependencies

To install the required dependencies, run:

# On Debian/Ubuntu-based systems
sudo apt install libinput-tools xdotool skippy-xd

Setup libinput-gestures

1. Install libinput-gestures from source or package manager:

# Debian/Ubuntu
sudo apt install libinput-gestures

# Add your user to the `input` group:
sudo gpasswd -a $USER input

2. Verify installation:

libinput-gestures-setup autostart
libinput-gestures-setup start

📂 File Structure

├── libinput-gestures.conf   # Main configuration file for gestures
├── scripts/
│   ├── 3-finger-swipe-up.sh  # Triggers Skippy-XD for window overview
│   ├── 3-finger-tap.sh       # Launches dmenu
│   └── other-scripts.sh      # Custom scripts for other gestures

✨ Features

3-Finger Swipe Up (Activate Skippy-XD)

Swipe three fingers up to activate a window overview using skippy-xd. This gesture allows you to view all open windows and switch between them easily.

• Script: scripts/3-finger-swipe-up.sh
• Command used: skippy-xd --activate-window-picker

3-Finger Tap (Launch dmenu)

Tapping with three fingers on the trackpad will open dmenu, a fast and minimal application launcher for your desktop.

• Script: scripts/3-finger-tap.sh
• Command used: dmenu_run

Custom Gestures

You can easily modify the existing gestures or add new ones by editing the libinput-gestures.conf file and linking them to your custom scripts. See the configuration section below for more details.

⚙️ Configuration

libinput-gestures.conf

Here is an example of how the libinput-gestures.conf file is structured to trigger the scripts:

# Swipe Up (3 fingers): Open skippy-xd
gesture swipe up 3 xdotool exec ~/scripts/3-finger-swipe-up.sh

# Tap (3 fingers): Open dmenu
gesture swipe down 3 xdotool exec ~/scripts/3-finger-tap.sh

# Add more gestures below as needed...

To apply changes to the configuration, restart libinput-gestures:

libinput-gestures-setup restart

🛠️ Customization

• Add New Gestures: Modify the libinput-gestures.conf file and create new scripts inside the scripts/ directory.
• Debugging: Run libinput-gestures -d to view gesture logs and troubleshoot any issues.

💡 Tips

• Ensure that your user is added to the input group by running sudo gpasswd -a $USER input.
• To autostart libinput-gestures on boot, run libinput-gestures-setup autostart.
• You can create more advanced gesture bindings by combining xdotool commands in your scripts.

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.

🤝 Contributions

Feel free to fork this repository and submit pull requests for any enhancements or additional gesture configurations you create!