MrAdi46 / Key-Splasher

Key-Splasher is a simple Python keylogger tool designed for educational and security auditing purposes. It captures keystrokes from a keyboard and logs them into a specified file. This tool can be used to demonstrate how keyloggers work, as well as to monitor user activity with proper authorization.

Key-Splasher

Key-Splasher is a simple keylogger tool designed to log keystrokes and display them with colored output in the terminal using Colorama.

Table of Contents

• Key-Splasher
  • Table of Contents
  • Features
  • Requirements
  • Installation
  • Usage
  • Initialization
  • Contributing
  • License
  • Contact

Features

• Keystroke Logging: Capture and log keystrokes.
• Colorful Output: Display status messages in color using Colorama.
• Log to File: Save captured keystrokes to a log file.

Requirements

-Python 3.x

-Dependencies

• argparse
• pynput
• logging
• colorama
• keyboard

Install dependencies using pip:

Installation

Clone the repository

git clone https://github.com/MrAdi46/Key-Splasher.git

cd Key-Splasher

Install Python dependencies

pip install -r requirements.txt

Usage

Run the Script

python key_splasher.py -f <log_file>

Example Usage

python key_splasher.py -f mykeylogs.txt

Run with Specified Log File

python key_splasher.py --log_file=mylogs.txt

Initialization

How-It-Works

• Key-Splasher initializes by setting up the log file and configuring the logging system.
• Key Press Handling: Captures each key press using pynput and appends the character or key name to an internal list.
• Key Release Handling: Captures each key release using pynput and appends the character.
• Log Writing: Periodically writes the captured keystrokes to the specified log file.

Threaded Execution

• Runs the keylogging function in a separate thread for continuous operation until manually stopped.

Security Notice

• Key-Splasher is intended solely for educational purposes or for use with explicit permission.

• Unauthorized use of keylogging software to capture keystrokes without consent is illegal and unethical. Always obtain permission from the owner of the system before using this tool.

Contributing

• Contributions are welcome! Please fork the repository and submit a pull request with your changes. For major changes, please open an issue first to discuss what you would like to change.

License

• This project is licensed under the MIT License.

Contact

For questions, suggestions, or issues, please reach out via the following channels:

• GitHub Issues: Create an issue
• GitHub Discussions: Join the discussion
• LinkedIn: Aditya Pachghare

Feel free to contact us for

• Bug Reports: If you encounter any issues while using Key-Splasher.
• Feature Requests: If you have ideas on how to improve Key-Splasher.
• General Inquiries: If you have questions or need assistance.

---