A simple yet powerful Python-based keylogger with an ethical focus. Open Source - MIT License. Contributions and suggestions are always welcome! - XamRyo
This repository contains a simple keylogger implemented in Python for educational purposes only. It is designed to demonstrate how keylogging works and should be used responsibly. Unauthorized use of this software may violate privacy laws and is strictly prohibited.
-
Captures and logs keypresses with Keyboard Event Handling:
- The
OnKeyboardEvent
function processes keyboard events, logs the key presses to a specified file, and provides additional information such as the window name and window handle.
- The
-
Destination Folder Definition:
- The keylogger stores data in a user-defined destination folder, specified by the
destination_folder
variable.
- The keylogger stores data in a user-defined destination folder, specified by the
-
Timeout Mechanism:
- The script waits a set time (in seconds) before sending an email. The
TimeOut
function checks whether the timeout has been reached and triggers the sending of captured data.
- The script waits a set time (in seconds) before sending an email. The
-
Email Notification:
- The
SendEmail
function reads captured data from the log file, formats it, and sends it via email using the SMTP protocol. ThecreateEmail
function handles email creation and transmission.
- The
-
Hook Manager Setup:
- The code uses the pyHook library to capture keyboard events through a hook manager.
-
Main Loop:
- The main loop checks for timeout and sends the captured data via email. It continuously processes any waiting messages.
- Python: Version 3.13.1 or higher
- Required Libraries:
git clone https://github.com/XamRyo/KeyloggerDelta-2.0V
cd KeyloggerDelta-2.0V
-
Install the required Python packages:
python -m pip install –upgrade pip. pip install pyHook pip install auto-py-to-exe pip install pywin32 pip install pynput pip install pyinstaller (optional) pip install time (general library) pip install logging
-
Run the script:
cd python KeyloggerDelta-2.0V.py
Convert the script into an executable file:
pyinstaller --clean --onefile --windowed .\KeyloggerDelta-2.0V.py
With auto-py-to-exe:
python -m auto_py_to_exe
This project is for ethical use only. The Dev-XamRyo are not responsible for any misuse. Ensure you have explicit permission to log keystrokes on any system where this tool is used ^-^)/
This project is licensed under the MIT License. Feel free to ask questions, contribute, or support the repository! 👍