{"id":26204978,"url":"https://github.com/karthik558/codelogger","last_synced_at":"2026-03-13T00:31:33.756Z","repository":{"id":199941611,"uuid":"704148477","full_name":"karthik558/CodeLogger","owner":"karthik558","description":"An advanced Python-based monitoring tool for educational and security research purposes.","archived":false,"fork":false,"pushed_at":"2025-05-23T15:41:21.000Z","size":309,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T10:57:33.744Z","etag":null,"topics":["cybersecurity-tools","educational-purposes","keystroke-injection","python-hacking-tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karthik558.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-10-12T16:27:19.000Z","updated_at":"2025-06-08T14:21:43.000Z","dependencies_parsed_at":"2024-01-10T09:29:11.788Z","dependency_job_id":"ecf5fc88-f65d-402b-8a7f-82cb942a8bee","html_url":"https://github.com/karthik558/CodeLogger","commit_stats":null,"previous_names":["karthik558/codelogger"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/karthik558/CodeLogger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karthik558%2FCodeLogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karthik558%2FCodeLogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karthik558%2FCodeLogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karthik558%2FCodeLogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karthik558","download_url":"https://codeload.github.com/karthik558/CodeLogger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karthik558%2FCodeLogger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30451537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T21:31:01.033Z","status":"ssl_error","status_checked_at":"2026-03-12T21:30:43.161Z","response_time":114,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity-tools","educational-purposes","keystroke-injection","python-hacking-tools"],"created_at":"2025-03-12T04:32:38.812Z","updated_at":"2026-03-13T00:31:33.749Z","avatar_url":"https://github.com/karthik558.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/FoORK-Lab/pass-gen-dependencies/refs/heads/main/CodeLogger.png\" alt=\"CodeLogger 2.0 Logo\" width=\"500\" style=\"border-radius: 15px;\"/\u003e\n\n### 🔐 Advanced Security Monitoring Tool 🔍\n\n[![GitHub license](https://img.shields.io/github/license/karthik558/CodeLogger?color=blue\u0026style=for-the-badge)](LICENSE)\n[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg?style=for-the-badge)](https://www.python.org/downloads/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/karthik558/CodeLogger/pulls)\n[![Last Updated](https://img.shields.io/badge/last%20updated-May%202025-orange)](https://github.com/karthik558/CodeLogger)\n\n\u003c/div\u003e\n\n## Overview\n\nCodeLogger 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.\n\n\u003e ⚠️ **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.\n\n## Key Features\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eMonitoring Capabilities\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003e🔑 \u003cb\u003eKeylogging\u003c/b\u003e: Records all keyboard input\u003c/li\u003e\n        \u003cli\u003e📸 \u003cb\u003eScreenshot Capture\u003c/b\u003e: Periodically captures screen images\u003c/li\u003e\n        \u003cli\u003e📋 \u003cb\u003eClipboard Monitoring\u003c/b\u003e: Tracks clipboard content changes\u003c/li\u003e\n        \u003cli\u003e🖥️ \u003cb\u003eSystem Information\u003c/b\u003e: Collects hardware, network, and user details\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eAdvanced Features\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003e📧 \u003cb\u003eEmail Reporting\u003c/b\u003e: Automatically sends collected data to specified email\u003c/li\u003e\n        \u003cli\u003e🔒 \u003cb\u003eEncryption\u003c/b\u003e: Secures logged data with PBKDF2 and Fernet encryption\u003c/li\u003e\n        \u003cli\u003e⏱️ \u003cb\u003eScheduling\u003c/b\u003e: Configurable intervals for data collection and reporting\u003c/li\u003e\n        \u003cli\u003e📊 \u003cb\u003eHTML Reports\u003c/b\u003e: Creates beautiful HTML and text reports\u003c/li\u003e\n        \u003cli\u003e🧙‍♂️ \u003cb\u003eConfiguration Wizard\u003c/b\u003e: Easy setup with interactive prompts\u003c/li\u003e\n        \u003cli\u003e💻 \u003cb\u003eCommand Line Interface\u003c/b\u003e: Powerful CLI options for flexibility\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Table of Contents\n\n\u003cdetails open\u003e\n  \u003csummary\u003eClick to expand/collapse\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#folder-structure\"\u003eFolder Structure\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#precautions\"\u003ePrecautions\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n## Prerequisites\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eRequired Software \u0026 Dependencies\u003c/b\u003e\u003c/summary\u003e\n  \n  * **Python 3.6 or higher**\n  * **Required Python Packages** (automatically installed via requirements.txt):\n    * pynput - For keyboard monitoring\n    * pillow - For screenshot capabilities\n    * cryptography - For encryption functions\n    * requests - For API communication\n    * psutil - For system information collection\n\u003c/details\u003e\n\n## Installation\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eStep-by-Step Installation Guide\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Clone the repository\ngit clone https://github.com/karthik558/CodeLogger.git\n\n# Navigate to the project directory\ncd CodeLogger\n\n# Install dependencies\npip install -r requirements.txt\n```\n\n\u003e **Note**: For macOS users, you may need to grant additional permissions for the tool to function properly.\n\n\u003c/details\u003e\n\n## Usage\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eCommand Line Options\u003c/b\u003e\u003c/summary\u003e\n  \n  ```bash\n  # Run the main program\n  python CodeLogger.py\n\n  # Run with configuration wizard\n  python CodeLogger.py --config\n\n  # Generate a report without starting monitoring\n  python CodeLogger.py --report-only\n\n  # Check the status of CodeLogger services\n  python CodeLogger.py --status\n\n  # Decrypt a file encrypted by CodeLogger\n  python CodeLogger.py --decrypt path/to/encrypted_file\n\n  # Show version information\n  python CodeLogger.py --version\n  ```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eRunning the Program\u003c/b\u003e\u003c/summary\u003e\n  \n  1. Configure the tool using the configuration wizard:\n     ```bash\n     python CodeLogger.py --config\n     ```\n  \n  2. Start monitoring:\n     ```bash\n     python CodeLogger.py\n     ```\n     \n  3. To stop the program:\n     - Press `Ctrl+C` in the terminal \n     - Or `Ctrl+Z` (`Command+Z` on macOS) while typing\n\u003c/details\u003e\n\n## Folder Structure\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eProject Directory Organization\u003c/b\u003e\u003c/summary\u003e\n\n  When running CodeLogger, the following folder structure will be created:\n\n  ```\n  CodeLogger/\n  ├── CodeLogger.py      # Main executable script\n  ├── config.json        # Configuration file\n  ├── output/            # Main output directory\n  │   ├── codelogger.log # Log file for program operations\n  │   ├── key.txt        # Keylog storage\n  │   ├── clipboard_history.txt # Clipboard monitoring storage\n  │   ├── screenshots/   # Directory for captured screenshots\n  │   │   └── screenshot_YYYYMMDD_HHMMSS.png\n  │   ├── system_info/   # Directory for system information\n  │   │   └── system_info_YYYYMMDD_HHMMSS.json\n  │   └── reports/       # Directory for generated reports\n  │       ├── report_YYYYMMDD_HHMMSS.html\n  │       └── report_YYYYMMDD_HHMMSS.txt\n  ├── src/               # Source assets\n  │   └── codelogger.jpg # Project logo\n  └── requirements.txt   # Python dependencies\n  ```\n\u003c/details\u003e\n\n## Precautions\n\n\u003cdiv class=\"warning\" style=\"padding: 10px; background-color: #161b22; border-left: 4px solid #FF9800; margin-bottom: 10px;\"\u003e\n  \u003cp\u003e\u003cstrong\u003eImportant Security and Legal Considerations:\u003c/strong\u003e\u003c/p\u003e\n  \u003cul\u003e\n    \u003cli\u003e✅ Always obtain proper authorization before deploying this tool\u003c/li\u003e\n    \u003cli\u003e🔑 When using the email functionality, it's recommended to use app-specific passwords\u003c/li\u003e\n    \u003cli\u003e🔄 Change the default encryption password and salt in the configuration\u003c/li\u003e\n    \u003cli\u003e⚖️ Be aware of privacy laws and regulations in your jurisdiction\u003c/li\u003e\n    \u003cli\u003e🚫 Never use this tool for malicious purposes or unauthorized surveillance\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/div\u003e\n\n## Contributing\n\n  \u003csummary\u003e\u003cb\u003eHow to Contribute\u003c/b\u003e\u003c/summary\u003e\n  \n  We welcome contributions to CodeLogger! Here's how you can help:\n  \n  1. **Fork** the repository\n  2. **Create a branch** for your feature: `git checkout -b feature/amazing-feature`\n  3. **Commit** your changes: `git commit -m 'Add some amazing feature'`\n  4. **Push** to your branch: `git push origin feature/amazing-feature`\n  5. Open a **Pull Request**\n  \n  For bug reports, feature requests, or feedback, please open an **Issue**.\n\n## License\n\n  \u003csummary\u003e\u003cb\u003eMIT License Terms\u003c/b\u003e\u003c/summary\u003e\n  \n  This project is licensed under the [MIT License](LICENSE) - see the LICENSE file for details.\n  \n  Copyright (c) 2025 CodeLogger Contributors\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMade with ❤️ by \u003ca href=\"https://karthiklal.in\"\u003eKARTHIK LAL\u003c/a\u003e\u003c/p\u003e\n    \u003cp\u003e\n      \u003ca href=\"https://github.com/karthik558/CodeLogger/issues\"\u003eReport Bug\u003c/a\u003e •\n      \u003ca href=\"https://github.com/karthik558/CodeLogger/issues\"\u003eRequest Feature\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarthik558%2Fcodelogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarthik558%2Fcodelogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarthik558%2Fcodelogger/lists"}