v1.0.3

USB_Ware v1.0.3

Board: ESP32-S2 (native USB)
License: MIT (educational use only)

USB_Ware is an educational USB/HID toolkit designed for ESP32-S2. It demonstrates captive portals, automated typing, and controlled brute-force PIN attacks in a safe lab environment.

---

Features

Captive Portal

• ESP32-S2 acts as an Access Point (AP) and redirects all DNS queries to itself.
• Includes three themed demo pages:
  • Minimal
  • Corporate-style
  • Neon

Android PIN Cracker (Brute-Force Demo)

• Brute-force a 6-digit PIN for instructional purposes.

HID Payloads

• Typing simulation with adjustable delays.
• Script execution via SPIFFS or embedded payloads.
• Optional “Rickroll” YouTube prank.

Configurable Settings

All key settings are configurable in the code.

---

Full Code Configuration

// ================= User Settings =================

// Select feature:
// Options:
// "richroll"           -> Rickroll YouTube prank
// "captive_portal"     -> Launch captive portal with DNS redirection
// "script"             -> Execute embedded HID scripts
// "script_richroll"    -> Script + Rickroll
// "barrel_roll"        -> Barrel roll animation/demo
// "note"               -> Type notes automatically
// "brute_force"        -> Android PIN brute force demo
// "all-brute_force"    -> All except brute force
const char* feature = "richroll";

// Brute-force delay in milliseconds per attempt
int bruteDelay = 100;

// Captive portal Wi-Fi AP settings
String inputSSID = "Captive portal";  // SSID
String inputPASS = "12345678";       // Password (leave empty for open network)
String portalName = "super portal";  // Portal name (super portal, super google, super pass)

// Encryption/Decryption mode: "e" = encrypt, "d" = decrypt
const char* MODE = "e";

// Target folder inside user profile (Desktop, Documents, Downloads, etc.)
const char* TARGET_FOLDER_NAME = "Desktop";

// Typing delay multiplier (affects HID typing speed)
float Delay = 40.0;

// YouTube URL for Rickroll payload
const char* linkURL = "https://www.youtube.com/watch?v=dQw4w9WgXcQ";

//--------------------------------------------------