CodeLogger 2.0 is a comprehensive security monitoring tool that records keystrokes, captures screenshots, monitors clipboard activity, gathers system information, and sends reports via email. The tool uses advanced encryption to secure collected data.
⚠️ DISCLAIMER: This tool is for educational and legitimate security testing purposes only. Unauthorized monitoring of computers or devices without consent is illegal in most jurisdictions. Always obtain proper authorization before deployment.
|
|
Click to expand/collapse
Required Software & Dependencies
- Python 3.6 or higher
- Required Python Packages (automatically installed via requirements.txt):
- pynput - For keyboard monitoring
- pillow - For screenshot capabilities
- cryptography - For encryption functions
- requests - For API communication
- psutil - For system information collection
Step-by-Step Installation Guide
# Clone the repository
git clone https://.com/karthik558/CodeLogger.git
# Navigate to the project directory
cd CodeLogger
# Install dependencies
pip install -r requirements.txtNote: For macOS users, you may need to grant additional permissions for the tool to function properly.
Command Line Options
# Run the main program
python CodeLogger.py
# Run with configuration wizard
python CodeLogger.py --config
# Generate a report without starting monitoring
python CodeLogger.py --report-only
# Check the status of CodeLogger services
python CodeLogger.py --status
# Decrypt a file encrypted by CodeLogger
python CodeLogger.py --decrypt path/to/encrypted_file
# Show version information
python CodeLogger.py --versionRunning the Program
Configure the tool using the configuration wizard:
python CodeLogger.py --config
Start monitoring:
python CodeLogger.py
To stop the program:
- Press
Ctrl+Cin the terminal - Or
Ctrl+Z(Command+Zon macOS) while typing
- Press
Project Directory Organization
When running CodeLogger, the following folder structure will be created:
CodeLogger/
├── CodeLogger.py # Main executable script
├── config.json # Configuration file
├── output/ # Main output directory
│ ├── codelogger.log # Log file for program operations
│ ├── key.txt # Keylog storage
│ ├── clipboard_history.txt # Clipboard monitoring storage
│ ├── screenshots/ # Directory for captured screenshots
│ │ └── screenshot_YYYYMMDD_HHMMSS.png
│ ├── system_info/ # Directory for system information
│ │ └── system_info_YYYYMMDD_HHMMSS.json
│ └── reports/ # Directory for generated reports
│ ├── report_YYYYMMDD_HHMMSS.html
│ └── report_YYYYMMDD_HHMMSS.txt
├── src/ # Source assets
│ └── codelogger.jpg # Project logo
└── requirements.txt # Python dependencies
Important Security and Legal Considerations:
- ✅ Always obtain proper authorization before deploying this tool
- 🔑 When using the email functionality, it's recommended to use app-specific passwords
- 🔄 Change the default encryption password and salt in the configuration
- ⚖️ Be aware of privacy laws and regulations in your jurisdiction
- 🚫 Never use this tool for malicious purposes or unauthorized surveillance
We welcome contributions to CodeLogger! Here's how you can help:
- Fork the repository
- Create a branch for your feature:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add some amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
For bug reports, feature requests, or feedback, please open an Issue.
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 CodeLogger Contributors
Made with ❤️ by KARTHIK LAL