Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

WiFi-controlled keystroke injection tool using ESP32 and CH9329

Notifications You must be signed in to change notification settings

Axion-Security/PhantomUSB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

17 Commits

Repository files navigation

Banner

PhantomUSB ๐Ÿ”ฎ

The Open-Source Keystroke Injection Device for Pentesters

Version License Price

PhantomUSB

PhantomUSB is a WiFi-enabled keystroke injection device with a built-in scripting engine and a dual LED status system. Powered by an ESP32 Wroom32U and CH9329, it enables seamless, remote-controlled automation of keyboard inputs over a secure WiFi AP. With low-latency execution, plug & play setup, and an intuitive web interface, PhantomUSB is designed for professionals who require precision, flexibility, and efficiency in automated keystroke execution.

โœจ Features

  • ๐Ÿ“ก Remote Keystroke Injection via Web Interface (WiFi Access Point)
  • ๐Ÿ’ก Dual LED Status System (Operation Feedback)
  • ๐Ÿ“œ Embedded Scripting Language (Documentation)
  • โšก Low-latency Communication with CH9329
  • ๐Ÿ› ๏ธ Plug & Play Setup with ESP32 Wroom32U & CH9329
  • ๐Ÿ”’ Secure Connection (WPA2 Protected)
  • ๐Ÿ“š Open Source (Fully Customizable)
  • ๐Ÿ“ฑ Cross-Platform Compatibility (Windows, Linux, Mac)
  • ๐Ÿš€ Easy Flashing using Web Flasher (Web Flasher)
  • ๐Ÿ“– Detailed Documentation (Learn)
  • ๐Ÿ’ธ Cheap & Affordable (DIY Components ~ 11ใƒ‰ใƒซ.24)

๐Ÿ›  Hardware Setup

๐Ÿ”Œ Pinout Diagram

ESP32 Wroom32U CH9329 LEDs
GND GND
VIN (5V) 5V
GPIO 17 TX
GPIO 16 RX
GPIO 19 LED Write
GPIO 18 LED Status

LED Behavior:

  • ๐Ÿ’š Write LED (GPIO 18): Blinks during script execution
  • ๐Ÿ’™ Status LED (GPIO 19): Solid = CH9329 Active and ready

๐Ÿ“ฆ Components

Component Quantity Price Source
ESP32 Wroom32U 1 ~ 5ใƒ‰ใƒซ AliExpress
CH9329 1 ~ 1ใƒ‰ใƒซ.85 AliExpress
LEDs (Blue and Green) 2 ~ 1ใƒ‰ใƒซ.59 AliExpress
Jumper Wires (10cm) 1 ~ 1ใƒ‰ใƒซ.30 AliExpress
IPEX to SMA Pigtail Antenna Set 1 ~ 1ใƒ‰ใƒซ.50 AliExpress
  • Total Cost: 11ใƒ‰ใƒซ.24 (Excluding Shipping)
  • ~ = Approximate Price
  • Note: Prices may vary based on the seller and location.
  • Soldiering is not required when using jumper wires.
  • ๐Ÿงฉ No Soldering Needed - Jumper wire compatible

๐Ÿ”ง Setup Guide

Showcase

  1. Glue the CH9329 to the back of the ESP32 (bottom side).
  2. Connect the CH9329 to the ESP32 using small jumper wires.
  3. Make sure everything fits well without parts sticking out.
  4. Connect the LEDs to the ESP32 (soldering is best for a strong connection).
  5. 3D Print (3mf File) or make a DIY case for the Phantom USB.

๐Ÿ“ถ WiFi Credentials

IP: 192.168.4.1
SSID: "PhantomUSB"
Password: "12345678910"

๐Ÿ“œ Scripting Language Documentation

Full Documentation:
https://learn.axionsec.pro/PhantomUSB/Phantom

Basic Commands:

  • โŒจ๏ธ write "text" - Type text with keyboard emulation
  • โŽ writeLn "text" - Type text + press Enter
  • โณ delay "ms" - Pause execution (milliseconds)

Advanced Features:

  • ๐Ÿ–ฅ๏ธ terminal "OS" - Auto-open system terminal (Windows/Linux/Mac)
  • ๐Ÿ”ข key "F1-F24" - Press any key
  • ๐Ÿงญ arrowKey "direction" - Navigate with arrow keys
  • ๐Ÿค– comboKey "key1+key2" - Press multiple keys simultaneously

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /