DuckyESP is an interpreter of Duckyscript™ language, it can parse Hak5® Rubber Ducky™ payload and execute the same commands on ESP32-S2/S3.
It fully supports Duckyscript 1.0 and almost all 3.0
Supported keywords, as per Duckyscript docs
| Keyword | Supported |
|---|---|
| STRING/STRINGLN | ✅ |
| DELAY | ✅ |
| DEFAULT_DELAY | ✅ |
| Cursor keys | ✅ |
| Modifier keys | ✅ |
| Lock keys | ✅ |
| System keys | ✅ |
| Key modifier combo | ✅ |
| REM | ✅ |
| REM_BLOCK | ✅ |
| WAIT_FOR_BUTTON_PRESS | |
| BUTTON_DEF | ❌ |
| DISABLE_BUTTON | ✅ |
| ENABLE_BUTTON | ✅ |
| LED_G/LED_R/LED_OFF | ✅ |
| Attackmode | ✅ |
| DEFINE | ✅ |
| VAR | ✅ |
| Operators | ❌ |
| Conditional statements | ❌ |
| Loops | ❌ |
| Functions | ❌ |
| Randomization | ✅ |
| Jitter | ✅ |
| Wait for lock keys |
- Wait for lock keys can be parsed but implementation is not available yet.
- Wait for button press can be parsed but implementation is not available yet.
- The other keywords(also the one that there aren't in the table) will be available in future
If you want to use a different layout from en_US you can put LAYOUT command at the begin of the script. More info here
Make sure that flex, bison and make are installed.
Then include the library using the git URL and follow the usage in example/ folder to use it.
This project is licensed under the GNU General Public License - see the LICENSE.md file for details.