A collection of tools to keep track of your keystrokes (keyr stands for keystrokes reporting).
keyr-daemoncounts your keystrokeskeyr-huballows for synchronizing your keystrokes count among several computerskeyr-agentmaintains a detailed log of your keystrokes statistics locally, and can communicatekeyr-hub
You will need the following programs to build keyr binaries.
- make
- meson and ninja
- rustc and cargo
Besides, keyrd requires the following runtime dependencies:
- udev
- libinput
You can build the project using make.
make
sudo make installkeyrd is a daemon: it is expected to be run in the background. It is
installed with the setuid bit, which means you do not need to start it
as root.
You can manage it as a user systemd service.
[Unit]
Description=keyr-daemon
PartOf=graphical-session.target
[Service]
Type=simple
ExecStart=/usr/local/bin/keyr-daemon
[Install]
WantedBy=sway-session.target
Prior to starting this service, systemctl --user import-environment
shall be run.
keyrd does only one thing: it counts. It does not deal with
persistence. This part is achieved by keyr-agent.
You need to execute keyr-agent regularly. If you use
waybar, you can use the custom
module to that end. In this case, keyr-agent can be used to print a
text in the bar.
{
...
"custom/keyr": {
"exec": "keyr-agent stage; keyr-agent format --template '{today_count | num_format} today ({global_count | num_format} total)'",
"format" : "{} ⌨",
"interval" : 5
},
...
}keyrd could not have been written without the source code of
wshowkeys, released under
the terms of the GPLv3 by Drew DeVault.