Skip to content

Axion-Security/HIDCrawler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ•·οΈ HIDCrawler

IMG_3902

Capture USB keystrokes with real-time feedback

🌟 Features

  • ⌨️ HID Device Support – Works with USB keyboards and compliant input devices.
  • πŸ’‘ LED Feedback – Blinks an LED on each keypress.
  • πŸ“‘ Serial Monitor Output – Streams typed characters to Serial Monitor.
  • ⏳ Debounce Logic – Prevents duplicate keypress detection.
  • πŸ”§ Modifier Handling – Supports shifted characters (e.g., A, !, @).

πŸ› οΈ Hardware Requirements

Component Purpose Optional?
Arduino Board Uno/Leonardo with USB Host Shield No
USB Host Shield Enable USB device connectivity No

πŸ”Œ Installation

  1. Clone the Repository

  2. Install Dependencies

  3. Upload the Code

    • Open HIDCrawler.ino in Arduino IDE.
    • Select your board (Arduino Leonardo).
    • Click Upload (➑️ icon).

⚑ Power Setup

⚠️ High-Power Devices
If your HID device isn’t detected or behaves erratically:

  1. Solder the 5V points on the USB Host Shield.
  2. Follow this 5V mod tutorial.

πŸ–₯️ Usage

  1. Open the Serial Monitor (Ctrl+Shift+M).

  2. Set baud rate to 115200.

  3. Start typing! Keystrokes will appear like this:

    Hello World!
    
  4. The LED will blink briefly for each keypress.


πŸ“š Dependencies

About

Keylogger based on Arduino Leonardo R3 and USB Host Shield

Topics

Resources

Stars

Watchers

Forks

Languages