{"id":13839543,"url":"https://github.com/spacehuhn/wifi_keylogger","last_synced_at":"2025-04-07T15:06:42.606Z","repository":{"id":117124376,"uuid":"87791967","full_name":"spacehuhn/wifi_keylogger","owner":"spacehuhn","description":"DIY Arduino Wi-Fi Keylogger (Proof of Concept)","archived":false,"fork":false,"pushed_at":"2019-07-24T11:48:07.000Z","size":874,"stargazers_count":352,"open_issues_count":5,"forks_count":69,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-03-31T12:08:29.099Z","etag":null,"topics":["arduino","c","esp8266","keylogger","leonardo","shield","wifi"],"latest_commit_sha":null,"homepage":null,"language":"Arduino","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spacehuhn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-04-10T09:21:18.000Z","updated_at":"2025-03-30T21:45:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"e4e3b9c2-29e6-4121-bec5-eda853d383e2","html_url":"https://github.com/spacehuhn/wifi_keylogger","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fwifi_keylogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fwifi_keylogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fwifi_keylogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fwifi_keylogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacehuhn","download_url":"https://codeload.github.com/spacehuhn/wifi_keylogger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675597,"owners_count":20977376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","c","esp8266","keylogger","leonardo","shield","wifi"],"created_at":"2024-08-04T17:00:29.530Z","updated_at":"2025-04-07T15:06:42.582Z","avatar_url":"https://github.com/spacehuhn.png","language":"Arduino","funding_links":["https://www.patreon.com/spacehuhn"],"categories":["Arduino","Arduino (2)"],"sub_categories":[],"readme":"# Wi-Fi Keylogger\n(Proof of Concept) Arduino Keylogger with Wi-Fi! \n\n![arduino leonardo with usb host shield and a nodemcu](https://raw.githubusercontent.com/spacehuhn/wifi_keylogger/master/images/keylogger_with_nodemcu_2.jpg)\n\n**Support me and my projects on [Patreon!](https://www.patreon.com/spacehuhn)**  \n[\u003cimg width=\"200\" alt=\"Support me on Patreon\" src=\"https://raw.githubusercontent.com/spacehuhn/wifi_keylogger/master/images/patreon.png\"\u003e](https://www.patreon.com/spacehuhn)  \n\n\n## Contents\n- [Introduction](#introduction)\n- [Disclaimer](#disclaimer)\n- [Installation](#installation)\n  - [Preparation](#preparation)  \n  - [ESP8266](#esp8266)\n  - [Arduino ATmega32u4](#arduino-atmega32u4)\n  - [Wire everything up](#wire-everything-up)\n- [How to use it](#how-to-use-it)\n- [License](#license)\n- [Sources and additional Links](#sources-and-additional-links)\n\n## Introduction ##\n\nUsing an Arduino with an ATmega32u4 (which can emulate a keyboard) and a USB host shield, this combination can be used as a keylogger. The addition of an ESP8266 allows you to store and retrieve the keystrokes in a log file.  \n\n**This is just a proof of concept**  \nPlease don't expect this to work with every keyboard layout!  \nI saw a few forum threads about making a USB keylogger with Arduino using a USB Host shield, but I couldn't find any published project about this.  \nSo I hope this is a good basis for someone who wants to make a proper keylogger, though **I won't develop this any further**.  \n\n## Disclaimer\n\nUse it only for testing purposes on your own devices!  \nI don't take any responsibility for what you do with this project.  \n\n## Installation\n\n### Short version:\nUpload the `keylogger` sketch to your Arduino (ATmega32u4) and upload the `esp8266_saveSerial` sketch to your ESP8266.  \nConnect your Arduino with the USB host shield and connect the serial pins (RX and TX (Arduino) to TX and RX (ESP8266)) and GND.\n\n---\n\n### Preparation\n\nWhat you will need:\n- **ESP8266 Wi-Fi chip**  \n- **Arduino with an ATmega32u4**  \n- **USB Host Shield**\n  There are different versions out there  \n![usb host shields](https://raw.githubusercontent.com/spacehuhn/wifi_keylogger/master/images/usb_host_shields.jpg)  \nHave a look at the official site: https://www.circuitsathome.com/usb-host-shield-hardware-manual/\n\nI used an Arduino Leonardo with the big host shield.  \n\n![arduino leonardo with USB host shield and a nodemcu](https://raw.githubusercontent.com/spacehuhn/wifi_keylogger/master/images/keylogger_with_nodemcu.jpg)  \n\nYou could probably build a very small version using the mini host shield and a pro micro.  \nhttp://forum.arduino.cc/index.php?topic=325930.0\n\n\n### ESP8266\n\nOpen the `esp8266_saveSerial` sketch with [Arduino](https://www.arduino.cc/en/Main/Software).  \nYou need to install the following Librarys:\n- [the latest ESP8266 SDK](https://github.com/esp8266/Arduino)\n- [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer)\n- [ESPAsyncTCP](https://github.com/me-no-dev/ESPAsyncTCP)\n\nThen compile and upload it to your ESP8266 (check if your settings are right).  \n\n### Arduino ATmega32u4\n\nYou will need the [USB Host Shield 2.0 Library](https://github.com/felis/USB_Host_Shield_2.0).  \nOpen the `keylogger` sketch in Arduino and upload it to your Arduino.  \n\n### Wire everything up\n\nOk so now you need to connect the ESP8266 with the Arduino.  \nConnect these pins:  \n\n| Arduino       | ESP82666      |\n| ------------- |:-------------:|\n| TX            | RX            |\n| RX            | TX            |\n| GND           | GND           |\n| VCC (3.3V)    | VCC (3.3V)    |\n\n**Note:** you'll need a 3.3V regulator if your Arduino only provides 5V.  \n**Don't connect the ESP8266 to 5V!**  \n\nIf you use a plain ESP-12, you also have to set the enable pin and to HIGH and GPIO15 to LOW:  \n\n| PIN          | Mode       |\n| ------------ |:----------:|\n| GPIO15       | LOW (GND)  |\n| CH_PD (EN)   | HIGH (3.3V)| \n\n## How to use it\n\nPlug the leonardo in the computer and the keyboard into the USB host shield. The ESP8266 will create a new access point `definitely not a keylogger`. Connect to it using the password `!keylogger`.  \nOpen your browser and go to `192.168.4.1`, you will see every keytroke.  \n\n![screenshot of the webinterface](https://raw.githubusercontent.com/spacehuhn/wifi_keylogger/master/images/screenshot.JPG)\n\nTo clear the logfile go to `192.168.4.1/clear`.  \n\n## License\n\nThis project is licensed under the MIT License - see the [license file](LICENSE) file for details\n\n## Sources and additional Links\n\nUSB Host shield:  https://www.circuitsathome.com/usb-host-shield-hardware-manual/\n                  https://www.arduino.cc/en/Main/ArduinoUSBHostShield\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhn%2Fwifi_keylogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacehuhn%2Fwifi_keylogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhn%2Fwifi_keylogger/lists"}