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://github.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