Repository navigation
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