Simple Keylogger

✨ deeznutz

✨ Master ✨
Staff member
May 15, 2017
Simple Keylogger – A simple keylogger for Windows, Linux and Mac

Welcome to the simple keylogger repo! A keylogger is a program that records your keystrokes, and this program saves them in a log file on your local computer.

Check out below to learn how to install them. These keyloggers are simple and bare bones, however they work great!

Currently, there are three keylogger programs for the major operating systems; Windows, Mac and Linux.

Installing Simple Keylogger


To change visibility of the window set the #define in line 6 to visible or invisible.

Simply compile into an .exe, and then run. Visual Studio is good for this.

invisible makes the window of the logger disappear, and it also

starts up hidden from view. Note that it is still visible in the task manager.

visible is visible, and the window does not close when typing. Great for testing it out.

Both of these save the keystrokes to a .txt file when closed.


This is a little more complicated. Please note, it does not work for secure areas such as password inputs. I have not found a work around yet.


Download the repo. It will install in /usr/local/bin/keylogger.

Install it:

$ git clone && cd keylogger
$ make && make install

It will log to /var/log/keystroke.log. This may require root access, but you can change that if you want. Set where you want it to log:

$ keylogger ~/logfile.txt
Logging to: /var/log/keystroke.log

Want to make it start on system startup?

$ sudo make startup

That will run it on startup.


$ sudo make uninstall

Will uninstall the program, but not the logs.

Thanks to Casey Scarborough for the base program!



You’ll need to install python-xlib if you don’t have it.

You can install it using pip:

pip install python-xlib
…or your system package manager:

sudo apt-get install python-xlib
Check that you have git installed, and then run this.

This will clone this entire repo. Find the linux folder, extract it, and open it. Rename the extracted folder to linux-logger Then run this:

root@linux:~$ cd linux-logger

There are several options that can be set with environment variables:

pylogger_file: File path to use as the log file. Default: ~/Desktop/file.log
pylogger_cancel: The key to use as the cancel key, in character form. Default: `
pylogger_clean: Whether to clear the file on startup. This can be set to anything to clear the file. Default: No (not set)

You can use Python 2 or 3 to run the logger.

To run it:

$ python
<class 'Xlib.protocol.request.QueryExtension'>
<class 'Xlib.protocol.request.QueryExtension'>
RECORD extension version 1.13
Or, using the options mentioned above:

# This tells the logger to use /home/me/myfile.txt,
# clearing the file on startup, and using ! as the
# cancel key.
# You don't have to use all of these options at once, or any at all.
$ pylogger_file=/home/me/myfile.txt
The keylogger is now running! It will log your strokes to the file you specified.
Stop it by hitting the cancel key (grave or `, if not set with <code>pylogger_cancel</code>.
That's the one under escape on a standard keyboard.)

You can make it run on startup:

$ sudo make startup


Some uses of a keylogger are:

Business Administration: Monitor what employees are doing.
School/Institutions: Track keystrokes and log banned words in a file.
Personal Control and File Backup: Make sure no one is using your computer when you are away.
Parental Control: Track what your children are doing.
Self analysis
Feel free to contribute to fix any problems, or to submit an issue!

Please note, this repo is for educational purposes only. No contributors, major or minor, are to fault for any actions done by this program.

Don’t really understand licenses or tl;dr? Check out the MIT license summary.

Distributed under the MIT license. See LICENSE for more information.

Top Bottom