bulletmark/libinput-gestures
Libinput Gestures
libinput-gestures is a Linux input event daemon and touchpad gesture mapper that translates libinput events into shell commands or keyboard shortcuts. It functions as a background process that monitors raw input signals to automate workflows and execute system actions based on a user-defined configuration file.
The tool allows for the mapping of multi-finger swipes and hold gestures to specific terminal commands or desktop workspace navigation. It differentiates between actions by filtering for finger counts, swipe directions, and the duration of hold gestures.
The system integrates with systemd for service lifecycle management, enabling the daemon to start automatically within graphical sessions. It handles the execution of custom scripts and system commands by spawning child processes in response to detected input patterns.
Features
- Touchpad Gesture Mappings - Translates multi-finger touchpad swipes and pinches into system commands or keyboard shortcuts.
- Touchpad Gesture Mapping - Translates specific touchpad movements into keyboard shortcuts or system commands via the input driver.
- Input Customization - Provides a way to redefine standard touchpad inputs to trigger custom shell commands and workflows.
- Input Event Translation - Translates libinput touchpad events into shell commands or keyboard shortcuts based on a configuration file.
- Shell Command Execution - Provides the capability to trigger and control operating system shell commands via input gestures.
- Background Input Daemons - Launches as a background system process that starts automatically upon entering a graphical session.
- Linux - Uses Linux-specific input interfaces to intercept touchpad events and redirect them to system actions.
- Gesture-to-Command Mappings - Uses a plain text configuration file to match detected gestures to specific system commands.
- Child Process Execution - Spawns external shell processes to execute terminal commands in response to touchpad gestures.
- Background Service Daemonization - Runs as a persistent background service to continuously monitor input events without a terminal.
- Input Event Polling - Monitors raw touchpad events via libinput to translate hardware signals into recognized gestures.
- Gesture-to-Action Controllers - Maps peripheral touchpad gestures to operating system commands via a configuration file.
- Application Lifecycle Managers - Provides commands to start, stop, and restart the background daemon process.
- Touch-Hold Duration Triggers - Differentiates between taps and hold gestures by tracking the duration fingers remain static.
- Systemd Services - Integrates with systemd units to manage the service lifecycle and ensure automatic startup.
- Workspace Navigation - Executes workspace navigation commands to switch between virtual desktops using gestures.
- Input Event Interceptors - Functions as a system-level hook that captures hardware input signals to trigger automated scripts.
- Input-Triggered Command Executors - Maps multi-finger swipes and hold gestures directly to the execution of custom terminal commands.
- Workspace Navigation - Enables reactive switching between virtual desktops and workspaces triggered by specific touchpad gestures.
- Gesture-Based Action Triggers - Triggers specific system actions in response to hold gestures on the touchpad.
- Directional Gesture Mapping - Assigns actions to cardinal directions or diagonal swipes to expand available input triggers.
- Gesture-to-Action Mappings - Maps specific finger counts to actions to allow multiple command mappings per motion.
- Finger Count Filtering - Specifies the exact number of fingers required to trigger specific gestures.
- Gesture Trigger Configuration - Allows definition of finger counts and duration delays to distinguish between different actions.
- Touch and Hold Delays - Assigns different commands to hold gestures based on the duration fingers remain static.
