=> back to xoc3.io

2021-11-22 - tmux keylogger

here is a shameless self promotion about a little script i made a few weeks ago. that script is called "tmux key log" or "tkl". just run "tkl" and you can have a little key logger running in your tmux status bar. this is super nice if you give presentations through the terminal, which is why i made it.

before i began work on this script, i saw one tmux keylogger script, but i think the developer was really just trying to see if it could be implemented in bash instead of creating something super useful. anyways, here is that project:

=> tmux keylogger implementation in bash

i wrote my script in python using the "keyboard" library, which you can find here:

=> keyboard library

i made sure it worked on both arch linux and darwin. i actually found 2 bugs in the keyboard library for darwin, so i fixed those bugs in some prs:

=> added linux feature to darwin | darwin fix for dvorak layout

some nice features of this little script:

• unicode is used to represent some keystrokes (eg: arrow keys are ←↑→↓)
• there is only 1 python dependency and the script is only 1 file
• ctrl, alt/option, super/cmd, and shift are all supported
• everything is saved in memory, instead of to a file
• only the last 40-ish keystrokes are saved in memory

here is an asciinema recording so you can see it for yourself:

=> tkl demo

and finally, here is that script you must be super excited about now:

=> tkl code