EvilDuck is a custom USB rubber ducky — a device that plugs into any computer and acts as a keyboard, executing pre-written payloads automatically. It’s inspired by WiFiDuck by Spacehuhn, which pairs an ESP8266 for WiFi with an ATmega32U4 for USB HID. EvilDuck takes that concept and builds on it with each hardware revision.

🦆 EvilDuck S3
The second generation. Built around the ESP32-S3, which handles both USB HID and WiFi natively on a single chip — no second microcontroller needed. The result is a more compact, more capable, fully self-contained device.

It adds a browser-based control panel over WiFi, SD card support for expanded storage, an addressable RGB LED, and a full DuckScript interpreter — all while staying the same physical size.

What’s New
Single-chip design — ESP32-S3 replaces the ATmega32U4 + ESP8266 combo
WiFi access point — browser-based control panel, no app required
Addressable RGB LED — WS2812 (2020 package), fully color-controllable in software
SD card support with expanded storage and USB mass storage mode
Over-the-air firmware updates via the web interface
DuckScript interpreter — executes scripts line by line as USB HID keystrokes
Autorun — plug in and a chosen script starts automatically
Stealth mode — adjusts timing and LED behavior
Hardware
Component Detail
Microcontroller ESP32-S3
WiFi Built-in (802.11 b/g/n)
USB Native USB HID (no second MCU)
Storage Internal SPIFFS + MicroSD
RGB LED WS2812 (2020 package)
Voltage Regulator LM1117 (5V → 3.3V)
Connector USB Type-A
Web Interface Features
Accessible over WiFi once the device is powered:

Upload, edit, save, and delete scripts
Trigger payloads remotely
Live execution status (current script + line number)
Execution log with warnings and errors
Stop a running script mid-execution
Send individual commands for quick testing
Built-in script library (Windows, Linux, macOS, demos, advanced)
Password-protected with optional hidden SSID
Configurable network name, password, and channel
Storage Modes
Internal flash (SPIFFS) — persistent across reboots
SD card — expanded storage, file transfer between internal and SD
USB mass storage mode — drag and drop files directly

v2.0.0 – ESP32-S3, WiFi Control & Full Redesign

The EvilDuck S3 is a complete hardware redesign. One chip, one board, everything the previous version couldn’t do.

Previous versions split the design across two chips and two use cases. The S3 brings it all together with the ESP32-S3, which handles USB HID and WiFi natively, no second microcontroller needed.

What’s New
Hardware
ESP32-S3 replaces the ATmega32U4 + ESP8266 combo
Single-chip handles both USB HID and WiFi
SD card slot added alongside internal SPIFFS storage
WS2812 RGB LED (2020 package) — fully addressable in software
LM1117 voltage regulator (5V → 3.3V)
RX/TX indicator LEDs for communication status
USB Type-A connector wired directly to ESP32 data pins
Firmware
Full DuckScript interpreter — executes scripts as USB HID keystrokes
WiFi access point with browser-based control panel
Autorun support with configurable boot delay
Stealth mode — adjusted timing and LED behavior
OTA firmware updates via web interface
Modular codebase: web server, script parser, storage, settings, USB
Web Interface
Upload, edit, save, and delete scripts over WiFi
Remote payload trigger
Live execution status (script name + current line)
Execution log with warnings and errors
Built-in script library (Windows, Linux, macOS, demos, advanced)
Password-protected with optional hidden SSID
Storage
Internal flash (SPIFFS) — persists across reboots
SD card support with file transfer between internal and SD