Keylogger reader

A Python-based keylogger for monitoring keystrokes and capturing the active window title on Linux systems. This tool listening to keystrokes and tracking the active window.

for more scripts related cyber and securiy check here: Cyber Security Scripts section.

⚠️ Disclaimer

This tool is intended for educational purposes only. It is illegal to use a keylogger to monitor others without their explicit consent. Use this software responsibly and only on systems where you have permission. Misuse may lead to legal consequences.

Features

• Keystroke Logging: Captures and records all keystrokes.
• Active Window Tracking: Logs the title of the active window.
• Modifier Key Support: Accurately records combinations involving Shift, Ctrl, and Alt keys.
• CapsLock Awareness: Adjusts logging based on CapsLock state.
• Multiple Output Formats:
  • Formatted log with color-coding
  • Unformatted log
  • Text-only log

Installation

Prerequisites

• Python 3.x

• pynput library for keyboard listening:

  pip install pynput

• xdotool for active window detection:

  sudo apt-get install xdotool

• python-xlib for interacting with X11 on Linux:

  pip install python-xlib

Clone the Repository

Clone the repository using the following command:

git clone https://github.com/YanivHaliwa/keylogger_reader.git
cd keylogger_reader

Usage

Run the Keylogger

To start the keylogger, run the following command:

python keylogger.py -l [--logfile] log.txt

• --logfile specifies the file where keystrokes will be logged. If not provided, the script will log to key_log.txt.

The script will create three log files:

• [log_file].txt: Formatted with color coding, best viewed in ANSI-supported terminals or Sublime Text with an ANSI plugin.
• [log_file]_not_formatted.txt: Unformatted log without color coding, suitable for viewing in any text editor.
• [log_file]_only_text.txt: ontains only plain text-only keystrokes without any special keys and no color formatting.

To stop the keylogger, use Ctrl+C.

Monitor Log File Remotely via SSH

To continuously monitor the keylogger output file remotely over SSH, use the following command:

ssh user@remote_host "tail -f /path/to/log_file.txt"

Example Output

• Window changes are logged as [Window Title] - the first time you switch to a new window.
• Special keys are logged in square brackets, e.g., [ENTER], [ESC].
• Modifier key combinations are logged as [CTRL+SHIFT+A].

⚠️ Security Note

After testing, make sure to delete any log files generated to prevent unintended data exposure, especially if the system is shared or used by multiple users.

Note

This tool is for educational and research purposes only. Ensure you have proper authorization before using it in any environment.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your improvements.

License

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

Summary of the MIT License: You are free to use, modify, and distribute this software as long as you include the original license. This software comes with no warranty.