linput

Listen to input events
git clone git://git.akobets.xyz/linput
Log | Files | Refs | README | LICENSE

README (1357B)


      1 linput - listen to input events
      2 -------------------------------
      3 linput is a Linux input event listener that
      4 runs a given command when a rule is matched.
      5 It reads input data from device files (/dev/input/event*).
      6 
      7 
      8 Requirements
      9 ------------
     10 * Linux headers.
     11 
     12 
     13 Installation
     14 ------------
     15 Edit config.mk to match your local setup.
     16 linput is installed in /usr/local namespace by default.
     17 
     18 Afterwards run the following command to build and install linput
     19 (if necessary as root):
     20 
     21     make install
     22 
     23 
     24 Configuration
     25 -------------
     26 linput is customized through editing config.h file and recompiling source code.
     27 
     28 Two types of rules can be configured: events and hotkeys.
     29 
     30 Events are simple rules that match a single input event.
     31 
     32 Hotkeys are rules for keyboard events.
     33 They consist of a modifier mask (Ctrl, Alt, etc.),
     34 a list of regular keys, and an event mask (trigger on press, release or hold).
     35 
     36 
     37 Recommendations
     38 ---------------
     39 linput opens device files, and it might not have permission to do this if it
     40 is not executed as root. If you'd like to execute it as normal user, you can achieve this
     41 with one of the following:
     42   - add user to a group that has read permission on input device files (e.g. 'input' group)
     43   - modify makefile to use setuid or setgid on the executable, so it always has needed permissions.
     44 
     45 
     46 Author
     47 ------
     48 Artem Kobets <artem@akobets.xyz>