OPCODE-Open-Spring-Fest/KeyLogger5155

🖥️ Keylogger 5155

A Python-based GUI Keylogger built with CustomTkinter, Pynput, and Pillow, capable of capturing keyboard inputs, screenshots, clipboard data, and system information — all managed via a beautiful graphical interface.

Overview

This project demonstrates how real-time keylogging, screenshot capturing, and automated reporting can be implemented securely using Python.
It provides:

• An interactive GUI to control all operations.
• Automatic logging of keyboard activity and clipboard data.
• Screenshot capture at some defined intervals.
• Optional email delivery of all collected logs.

Features

1. Keylogging

• Captures every keystroke pressed on the keyboard.
• Logs include letters, numbers, function keys, and special keys (Enter, Backspace, etc.).
• Stored safely in:

  app/data/key_log.txt
  

2. Clipboard Capture

• Periodically reads clipboard data (text).
• Stores the last copied text content into:

  app/data/clipboard.txt
  

3️. Screenshot Capturing

• Takes full-screen screenshots at regular intervals using Pillow (PIL).
• The image is timestamped and saved automatically.
• All screenshots are stored as PNGs in:

  app/data/screenshots/
  

4️. System Information Logging

• Gathers important device details such as:
  • OS name and version
  • Hostname
  • Processor type
  • IP address
• Saved in:

  app/data/systeminfo.txt
  

5. Email Automation

• Periodically sends collected logs and screenshots as ZIP file via email.
• Credentials and recipient are securely managed via .env file.

📁Folder Structure

📦 GKeylogger-5155
├── app/
│   ├── data/
│   │   ├── key_log.txt
│   │   ├── clipboard.txt
│   │   ├── systeminfo.txt
│   │   └── screenshots/
│   │       └── *.png
│   ├── .gitignore
│   ├── guikeylogger.py
│   ├── requirements.txt 
├── config.json
├── package.json
└── README.md

Configuration Details (config.json)

The config.json file lets you customize paths, intervals, email, and GUI settings — no code changes needed.

Default Config

"paths": {
"data_dir": "data",
"keys_file": "data/key_log.txt",
"system_file": "data/systeminfo.txt",
"clipboard_file": "data/clipboard.txt",
"screenshot_dir": "data/screenshots"
},
"intervals_seconds": {
"screenshot_interval": 900,
"email_interval": 900,
"clipboard_interval": 30
},
"screenshots": { "keep_latest": 10 },
"email": {
"smtp_host": "smtp.gmail.com",
"smtp_port": 587,
"from_env": true
},
"gui": { "icon": "cracking.ico", "image": "cracking.png", "window_title": "Key Logger 5155" },
"safety": { "require_confirm": true }
}

Parameter Summary -

- Modify these values to change log intervals, file paths, or email setup without touching the source code.

Tech Stack

• Python 3.9+
• CustomTkinter
• Pynput
• Pillow (PIL)
• Pyperclip
• smtplib (built-in)
• python-dotenv 1.0+

Installation & Setup

1. Clone Repository

git clone https://github.com/<your-username>/Keylogger5155.git
cd Keylogger5155/app

2. Create Virtual Environment

python -m venv venv
venv\Scripts\activate     # Windows
source venv/bin/activate  # Linux/Mac

3. Install Requirements

pip install -r requirements.txt

4. Configure Environment

Create a .env file:

email=email@gmail.com
pass=password

6. Run the App

python guikeylogger.py

Example Output

📁 data/
├── key_log.txt
│    [2025-11-01 08:30:12] Key pressed: A
│    [2025-11-01 08:30:13] Key pressed: B

├── clipboard.txt
│    Copied Text: "Hello World"

├── screenshots/
│    screenshot_2025-11-01_08-31-00.png

└── systeminfo.txt
│    OS: Windows 10
│    Hostname: user-PC
│    Processor: Intel Core i5
│    IP: 192.xxx.x.5

Contributing

1. Fork the repo
2. Create a feature branch

   git checkout -b feature-name

3. Commit changes

   git commit -m "Added new feature"

4. Push and create a Pull Request

Community

This project is part of Opcode, IIIT Bhagalpur. Maintainers will review PRs, suggest changes, and merge contributions. Use Issues to report bugs or suggest features.