Skip to content

README.md

Latest commit

 

History

History
59 lines (42 loc) · 1.32 KB

README.md

File metadata and controls

59 lines (42 loc) · 1.32 KB

Python Keylogger with Email Reporting (Educational Project)

This project is a Python-based keylogger.
It logs keystrokes with timestamps into a file and automatically emails the log file when the ESC key is pressed.

⚠️ This project is strictly for educational purposes only. 😂 Use it only on systems you own or have explicit permission to test.

✨ Features

  • Logs keyboard input with date & time
  • Saves logs to a file (data.txt)
  • Stops execution on pressing ESC
  • Automatically emails the log file as an attachment
  • Uses environment variables for sensitive data

🛠️ Technologies Used

  • Python 3
  • pynput (keyboard listener)
  • smtplib (email sending)
  • python-dotenv (environment variable management)

🔐 Environment Variables (.env)

Create a .env file in the project root:

SENDER_EMAIL = "your_email@gmail.com"
RECEIVER_EMAIL = "receiver_email@gmail.com"
PASSWORD = "your_app_password"

🔑 Note:

For Gmail, use an App Password, not your normal password.

Enable 2-Step Verification in your Google account.

📦 Installation

1️⃣ Clone the repository

git clone https://github.com/Varun04-pixel/keyLogger.git
cd project-folder

2️⃣ Install dependencies

pip install pynput python-dotenv

▶️ Usage Run the script:

python keylog.py