⚠️ This project is intended only for ethical hacking education and cybersecurity awareness. It does not send data over the internet and is safe to run locally.
This Python-based Keylogger Simulator demonstrates how basic keylogging tools work by capturing keyboard input locally. It helps cybersecurity students and ethical hackers understand the mechanics behind keyloggers in a legal and controlled environment.
- ✅ Captures all keystrokes with timestamps
- ✅ Automatically writes logs to
logs/key_logs.txt - ✅ Terminates safely when the
ESCkey is pressed - ✅ Uses threading to flush logs every 60 seconds
- ✅ 100% offline – does not send data anywhere
- ✅ Beginner-friendly and well-documented code
- Clone the repo or download the ZIP
git clone https://github.com/YOUR_USERNAME/Keylogger-Simulator.git
cd Keylogger-Simulator- Install dependencies
pip install -r requirements.txt- Run the simulator
python keylogger.pyPress ESC key anytime to stop the logger.
View the sample log file here:
👉 logs/key_logs.txt
Keyloggers are common in both offensive and defensive security:
🛡️ Blue teams learn how to detect them
🕵️ Red teams learn how they’re made (ethically)
🧑🎓 Students understand keyboard event listeners
This simulator helps bridge the knowledge gap safely.
This tool is intended only for personal learning, ethical hacking labs, and red team simulations with full consent. Do not use this on anyone’s device without explicit permission.
If you found this useful, consider ⭐ starring the repo or connecting with me on LinkedIn.