MarinX/ keylogger
About the developer
164 Stars 
47 Forks 
MIT License 
22 Commits 
2 Opened issues 
Description
Basic keylogger in Go (no C deps)
Services available
Keylogger
Capture global keyboard events on Linux
Notes
- Only Linux based
- Need root privilages
Installation
go get github.com/MarinX/keylogger
Getting started
Finding keyboard device
There is a helper on finding the keyboard.
go keyboard := keylogger.FindKeyboardDevice()Which goes through each file device name to find keyword "keyboard"
sh /sys/class/input/event[0-255]/device/nameand returns the file event path if found
sh /dev/input/event2If the function returns empty string, you will need to cat each device name and get the event number. If you know already, you can easily pass it to constructor
sh
keylogger.New("/dev/input/event2")
Getting keypress
Once the keylogger returns channel event, you can switch by event code as described in input_event.go For start, you can listen on keyboard state change
go keylogger.EvKeyOnce you get desire event, there is a helper to parse code into human readable key.
go event.KeyString()
Writing keypress
Best way is to open an text editor and see how keyboard will react There are 2 methods:
go func (k *KeyLogger) WriteOnce(key string) errorand
go func (k *KeyLogger) Write(direction KeyEvent, key string) error
WriteOncemethod simulates single key press, eg: press and release letter M
Writewrites to keyboard and sync the event. This will keep the key pressed or released until you call another write with other direction eg, if the key is "A" and direction is press, on UI, you will see "AAAAA..." until you stop with release
Probably you want to use
WriteOncemethod
NOTE
If you listen on keyboard state change, it will return double results. This is because pressing and releasing the key are 2 different state change. There is a helper function which you can call to see which type of state change happend ```go // returns true if key on keyboard is pressed event.KeyPress()
// returns true if key on keyboard is released event.KeyRelease() ```
Example
You can find a example script in
example/main.go
Running tests
No magic, just run
sh go test -v
Creating key sniffer (needs update)
License
This library is under the MIT License