https://github.com/vpratham/advanced-key-logger
A Python-based keyboard event monitoring system that captures and transmits keystroke data securely over a network connection.
https://github.com/vpratham/advanced-key-logger
cybersecurity keylogger keylogger-python python security-automation security-tools socket-programming windows
Last synced: 3 months ago
JSON representation
A Python-based keyboard event monitoring system that captures and transmits keystroke data securely over a network connection.
- Host: GitHub
- URL: https://github.com/vpratham/advanced-key-logger
- Owner: vpratham
- Created: 2024-12-26T11:55:34.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-01-02T16:58:12.000Z (5 months ago)
- Last Synced: 2025-01-02T17:45:01.156Z (5 months ago)
- Topics: cybersecurity, keylogger, keylogger-python, python, security-automation, security-tools, socket-programming, windows
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Keyboard Event Monitor
## Overview
This project implements a Python-based keyboard event monitoring system with network capabilities. It's designed for legitimate system monitoring and diagnostic purposes, featuring efficient event processing and network transmission.
## Technical Features
- Asynchronous keyboard event processing
- Memory-efficient buffering system
- Network transmission with retry capability
- Thread-safe operations
- Configurable monitoring intervals
## Requirements
- Python 3.7+
- Required packages:
```
pynput>=1.7.3
```
## Installation
1. Clone the repository
2. Install dependencies:
```bash
pip install -r requirements.txt
```
## Configuration
Edit the `key.py` file to set the following parameters:
```python
SERVER_IP_ADDR = "your_server_ip"
SERVER_PORT = your_port_number
TIME_INTERVAL = transmission_interval_in_seconds
```
## Project Structure
```
.
├── client.py # Main implementation file
├── key.py # Configuration constants
└── README.md # This file
```
## Implementation Details
### Core Components
#### KeyLogger Class
The main class handling keyboard monitoring and event processing.
Key features:
- Event buffering using StringIO
- Thread-safe operations with buffer locks
- Queued event processing
- Configurable network transmission
#### Network Operations
- TCP-based transmission
- Automatic retry on connection failure
- Server acknowledgment handling
#### Performance Optimizations
- Asynchronous event processing
- Memory-efficient buffering
- Reduced disk I/O
- Optimized thread management
## Usage
Run the program with:
```bash
python client.py
```
The program will:
1. Initialize the monitoring system
2. Create necessary directories
3. Begin processing keyboard events
4. Transmit data at configured intervals
## Error Handling
The system includes comprehensive error handling for:
- Network connectivity issues
- File system operations
- Memory management
- Thread synchronization
## Monitoring and Logging
- Console output for diagnostic information
- Error logging for troubleshooting
- Network transmission status updates
## Technical Considerations
- CPU usage is optimized through event queuing
- Memory usage is controlled via buffer management
- Network transmission is handled in separate threads
- File I/O is minimized to improve performance
## Development and Testing
For development purposes:
1. Set shorter `TIME_INTERVAL` values
2. Monitor console output for diagnostics
3. Check network connectivity with test server
## Performance
The system is optimized for minimal system impact:
- Efficient event queuing
- Controlled memory usage
- Reduced disk operations
- Optimized thread management
## Troubleshooting
Common issues and solutions:
1. Connection failures:
- Verify server address and port
- Check network connectivity
- Confirm firewall settings
2. Performance issues:
- Adjust queue size
- Modify processing intervals
- Check system resources