Skip to content
A simple and effective keylogger with minimal dependencies and permissionless operation.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Keylogger
LICENSE
README.md

README.md

Keylogger

Keylogger is a a simple, yet effective, Keylogger that uses minimal resources and dependencies. It tracks all keyboard input, writes input to a log file, sends the file to an email address, then encrypts the local file. It can be customized to reflect any keymap with ease and depending on the use can be refactored to be more obscure.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Supported Operating Systems: Windows 10, Windows 8, Windows 7

Supported Email Client: Gmail

To use the email feature, you must go into your Google Account settings for the "Sender" address, and allow less secure apps to sign in to the account. I reccommend creating a separate email account for this purpose.

For example:

A Windows 10 machine can run the keylogger and send the email using valid Gmail addresses. In the program, the "Sender" variables will contain the email and password to send the log files using a powershell script.

Installing

  1. Install CodeBlocks MinGW (codeblocks-17.12mingw-setup.exe) is the version I used.
  2. Add -mwindows to compiler and linker options
  3. Add support for C++11
  4. Clone the repo
  5. Make any adjustments to the program desired such as time intervals, email credentials, keymappings, etc.
  6. Compile and build
  7. Run the exe.

You will find the encrypted keylogs in: C:\Users*Username\AppData\Roaming\Microsoft\CLR.

If you would like to decrypt them, simply write the reverse of the encryption used as another console app and pass the log file as input and a new decrypted file as output. I may write one and upload it, but you get the readable keylogs sent over SMTP to your destination email already.

Inspiration

I wanted to make something that would be doable in a day as a solo developer for the MLH Local Hack Day hackathon, as well as provide practical use in an ethical hacking, cybersecurity, and system administration setting.

What it does

Keylogger runs silently in the background without permissions, gathers all key events, logs them into a file, sends that file securely over SMTP to the threat agents email, then encrypts the keylog on the infected host using a salted base64 encoding algorithm.

How I built it

I built the project using Code::Blocks. The design pattern is OOP and is divided up into multiple functionalities via header files, then built the various functions required such as encryption, asynchronous time management, key hooks, the key map, email, as well as various helper functions.

Challenges I ran into

Learning about asynchronous operations and object states was a difficult path to making everything not only run continuously in the background, but without being hindered by other operations. The powershell scripting for the email functionality was particularly cumbersome due to the conversion into a C++ string.

Accomplishments that I'm proud of

I was pretty tempted to give up at making it work in the last 6 hours after finishing it. I had all of the code done, but couldn't debug it for hours to the point where I was about to just move on, but I stuck with the challenge and completed a working application that does everything I set out for it to do.

What I learned

Powershell is not fun to manage through C++, and keyloggers can be pretty creepy.

What's next for Keylogger

Next I will be building a front end to interact with the keylogger and display the outputs being sent from the infected test hosts. The idea is to allow anybody to see the logs online as a way to conceptualize the vulnerability. I'll probably have to add an SFTP script in the keylogger to send logs to a database to be displayed on the front end.

Built With

  • c++
  • powershell

Acknowledgements

This program was built as a result of completing the Ethical Hacking course created by Ermin Kreponic. It was a great learning experience, especially since the material was outdated and required a lot of debugging to get working. This software is not intended to be used for malicious/illegal purposes.

Copyright (c) 2016 Ermin Kreponic Modifications Copyright (c) 2018 Kyle May

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

You can’t perform that action at this time.