Repository files navigation

NOTE: This project should be used for authorized testing or educational purposes only.You are free to copy, modify and reuse the source code at your own risk.

Some uses of a keylogger are:

• Security Testing: improving the protection against hidden key loggers;
• Business Administration: Monitor what employees are doing (with their consent);
• 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 and assessment.

• Global event hook on all (incl. On-Screen) keyboards using cross-platform libraryKeyboard. The program makes no attempt to hide itself.
• Pure Python, no C modules to be compiled.
• 2 logging modes:
  • Storing logs locally and (optionally) sending logs to your onion hidden service via Tor (Tor auto-install optional; disabled by default).
  • Debug mode (printing to console).
• Persistence (opt-in):
  • Adding to Windows Startup only when the 'persist' flag is provided.
• Human-readable logs:
  • Logging keys as they actually are in your layout; cyrillic keyboard layout is fully implemented;
  • Logging window titles and current time where appropriate;
  • Backspace support (until the active window is changed);
  • Full upper-/ lowercase detection (capslock + shift keys).
• Privacy protection:
  • RSA public-key encryption of logs on the fly usingPyCryptoDome.

• MS Windows 10/11. Linux/macOS are not supported.
• Python 3 (tested on v. 3.13).

1. git clone https://github.com/secureyourself7/python-keylogger
2. cd python-keylogger
3. Customize parameters in start.py: url_server_upload, hidden_service_check_connection.

3. pip install -r requirements.txt (alternativelypython -m pip ...)
4. python start.py

3. pip install pyinstaller
4. pyinstaller --onefile --noconsole --icon=icon.ico start.py
5. dist\start.exe

1. Generate RSA key pair (optional):python rsa_key_generator.py.
2. Change the public key filename / paste the key in start.py.
3. To decrypt logs typepython log_decryptor.py, and then follow the instructions given by the script.

start.py mode [encrypt] [persist] [--allow-tor-install]

• modes:
  • local: store the logs in a local txt file. Filename is a MD5 hash of the current date (YYYY-Mon-DD).
  • debug: write to the console.
• [optional]
  • encrypt: enable the encryption of logs with a public key provided in start.py.
  • persist: add to Windows Startup (Windows only).
  • --allow-tor-install: allow Tor Browser auto-install (Windows only). Disabled by default.

https://www.youtube.com/watch?v=uODkiVbuR-ghttps://www.youtube.com/watch?v=8BiOPBsXh0g

• Does not capture passwords auto-typed by KeePass, however, it captures KeePass DB passwords.
• SeeKeyboard: Known limitations.Feel free to contribute to fix any problems, or to submit an issue!

Cyrillic layout is implemented, meaning support for these languages: Russian, Russian - Moldava, Azeri, Belarusian, Kazakh, Kyrgyz, Mongolian, Tajik, Tatar, Serbian, Ukrainian, Uzbek.

Please note that this repo is for educational purposes only. No contributors, major or minor, are responsible for any actions made by the software.

Distributed under the MIT license. SeeLICENSE for more information.