Skip to content

diego-plan9/lillinput

lillinput

license build status

About

lillinput logo

lillinput is a small utility written in Rust for connecting libinput gestures into:

  • commands for the i3 tiling window manager IPC interface
  • shell commands

Since version 0.3.0, the project is split into two crates:

Command-line application

crates.io cli

lillinput-cli: the command line application.

Example usage

$ lillinput -e i3 -e command --three-finger-swipe-up "i3:workspace next" --three-finger-swipe-down "command:touch /tmp/myfile"

For the documentation related to the command-line application, please check the README.md for the lillinput-cli crate.

Library

crates.io lib docs.rs lib

lillinput: the library providing the building blocks.

For the documentation related to the library, please check the README.md for the lillinput crate.

Project status

Please be aware that this project is in beta, and was started for scratching a specific itch - allowing three-finger swipe for changing between workspaces in i3 under a custom setup. It aims to stay small (hence the project name and its "three-fingers-captured-by-fierce-tiny-island-inhabitants" logo, a homage to Gulliver's Travels) and biased towards custom needs (and a bit of a personal Rust playground).

Compiling

Dependencies

The following system-level libraries are required by this crate dependencies:

sudo aptitude install libudev-dev libinput-dev

Related projects

This crate relies heavily on the wonderful work on the input and i3ipc crates (among others) - kudos to their maintainers for making them available.

Outside rust, the following projects provide a more complete solution for using libinput gestures:

Contributing

Any contribution is welcome, please issue or PR away! Please refer to the CONTRIBUTING.md document for more details.

License

This project is licensed under BSD-3-Clause.