Seytonic / Duckduino-microSD

Interpreter that runs on an arduino, decodes and executes ducky script on a microSD card.
290 stars 109 forks source link

Duckduino-microSD

Interpreter that runs on an arduino, decodes and executes ducky script on a microSD card.

Benefits Over Alternatives

Once the arduino has been programmed, you need only deal with ducky scripts on a microSD card. No reprogramming the arduino to change scripts!

Setup

video link

The instructions are for an arduino pro micro, it should work on any arduino using an atmega32u4 chip such as the leonardo. Simply upload Duckduino-microSD to your arduino, forma your microSD to FAT32 and save your script on the microSD card titled script.txt Lastly, connect a microsd breakout board using the pins below

Arduino ||| microSD module

VCC  --->   VCC

D15  --->   SCK

D14  --->   MISO

D16  --->   MOSI

GND  --->   GND

D4   --->   CS

Keep in mind...

Long lines of strings may crash the arduino due to taking up too much RAM, if you have a line "STRING ..." over 300 characters then split it into separate lines of strings, this won't affect how your script runs, it just reduces how much of your script is held in memory at any one time.

I have seen some ducky scripts that put hyphens (-) in between keys to be pressed simultaneously eg."CTRL-ALT DELETE". Note that when using duckduino-microSD you must not use hyphens and instead just use spaces eg."CTRL ALT DELETE"

The following duckyscript features are not yet implemented: DEFAULT_DELAY, REPLAY. This project uses arduino's inbuilt keyboard.h library, any keys not implemented in that will not work with this. eg: PRINTSCREEN.

This has only been tested on the following microSD module, I'm sure others will work, though no guarantees.