keystroke-sim 0.3.0

Cross-platform keyboard input simulation and monitoring with security analysis

KeystrokeSimulator

A comprehensive Python library for keyboard input simulation, monitoring, and security analysis, developed by Bassem Abidi ([e-mail]).

Features

Keystroke Simulation

• 🎯 Cross-platform support (Windows, macOS, Linux)
• ⌨️ Simulate individual keystrokes
• 📝 Type strings with customizable delays
• 🔥 Support for hotkey combinations
• 🔧 Custom keyboard layout definitions

Keyboard Monitoring

• 📊 Real-time keystroke logging
• 📈 Detailed keystroke statistics
• 🔍 Key combination tracking
• 📅 Date-organized logs
• 📊 Usage analytics

Security Features

• 🔐 Keystroke dynamics analysis
• 👤 User behavior profiling
• 🚨 Threat detection
• 🎯 Anomaly detection
• 📋 Security reporting
• 🔒 Encrypted logging
• 📊 Statistical analysis

Quick Start

Installation

pip install keystroke-sim

Basic Usage

1. Keystroke Simulation:

from keystroke_sim import KeystrokeSimulator

# Initialize simulator
sim = KeystrokeSimulator()

# Type text
sim.type_string("Hello, World!", delay=0.1)

# Press hotkey
sim.press_hotkey(['ctrl', 'c'])

2. Keyboard Monitoring:

from keystroke_sim import KeyboardMonitor

# Initialize monitor
monitor = KeyboardMonitor()

# Start monitoring
monitor.start()

3. Security Analysis:

from keystroke_sim.security_analyzer import KeystrokeSecurityAnalyzer

# Initialize with encryption
analyzer = KeystrokeSecurityAnalyzer(encryption_key="your-secret-key")

# Create user profile
analyzer.create_baseline_profile(training_data)

# Monitor for threats
threats = analyzer.detect_threats(current_data)

# Generate security report
report = analyzer.generate_security_report(data)

Security Features in Detail

1. Keystroke Dynamics Analysis

• User typing pattern recognition
• Timing analysis (key press duration, flight time)
• Rhythm consistency measurement
• Pattern deviation detection

2. Threat Detection

# Initialize security components
monitor = KeyboardMonitor()
analyzer = KeystrokeSecurityAnalyzer()

# Configure threat detection
def on_threat(threat):
    print(f"Threat detected: {threat['type']}")
    print(f"Severity: {threat['severity']}")
    print(f"Details: {threat['details']}")

# Start monitoring
monitor.on_threat = on_threat
monitor.start()

3. Security Reports

# Generate comprehensive security report
report = analyzer.generate_security_report(data)

# Report includes:
# - Risk score
# - Detected threats
# - Timing analysis
# - Pattern anomalies
# - Statistical metrics

4. Encrypted Logging

# Initialize with encryption
analyzer = KeystrokeSecurityAnalyzer(encryption_key="your-secret-key")

# Encrypt sensitive data
encrypted_data = analyzer.encrypt_log_data(log_data)

# Decrypt when needed
decrypted_data = analyzer.decrypt_log_data(encrypted_data)

Command Line Interface

Monitor Mode

# Basic monitoring
keystroke-sim monitor

# Advanced security monitoring
keystroke-sim monitor --security --sensitivity 0.8

Simulation Mode

# Type text
keystroke-sim simulate --text "Hello, World!" --delay 0.1

# Press hotkey
keystroke-sim simulate --hotkey ctrl c

Security Best Practices

1. User Profiling

   • Collect sufficient training data
   • Update profiles periodically
   • Monitor profile consistency

2. Threat Detection

   • Adjust sensitivity based on security needs
   • Review security reports regularly
   • Investigate alerts promptly

3. Data Protection

   • Always use encryption for sensitive data
   • Secure encryption keys properly
   • Regular security audits

4. Monitoring

   • Set appropriate alert thresholds
   • Configure logging levels
   • Regular backup of security reports

Advanced Configuration

Security Analyzer Configuration

config = {
    'sensitivity': 0.7,
    'min_training_data': 1000,
    'alert_threshold': 0.8,
    'encryption_enabled': True
}

analyzer = KeystrokeSecurityAnalyzer(config=config)

Custom Security Rules

# Define custom threat detection rules
def custom_threat_detector(data):
    # Your custom detection logic
    return threats

analyzer.add_threat_detector(custom_threat_detector)

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: python -m pytest tests/
5. Submit a pull request

Support

For issues, questions, or contributions:

• GitHub Issues: https://github.com/bassemabidi/keystroke_sim/issues
• Email: [e-mail]

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Bassem Abidi ([e-mail])

Version History

See CHANGELOG.md for version history and changes.