keystroke/INSTALL at master · gergap/keystroke · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Keystroke install instructions:
==============================

Requirements:
------------

* gcc/g++
* cmake 2.8 or higher
* Qt 4.x

Quick build:
-----------

# default build options
./build.sh

# developer build
./build.sh dev

Building manually:
-----------------

If you know CMake it should be straight forward for you.
Here are the necessary steps:

mkdir bld
cd bld
cmake ..
make
sudo make install

Note: The install step makes the executable owned by root and sets the SETUID
bit. This is necessary, because the applications needs root privileges to open
the keyboard device. After the device was opened it drops this root privileges
for security reasons.

Running:
-------

/usr/local/bin/keystroke-gui

After starting the tool you should already see all keystrokes popping up at the
bottom of the screen. Also a systray icon is shown, which you can use to open
the configuration dialog.

The systray icon can also be used to quit the application.

Shortcuts:
---------

META-F10: toggles the enabled state of the keygrabber. This way you can disable
          the tool temporary, e.g. when you are entering a password.