README.md

PotatoParser

Converter of Ducky Script to Arduino sketch with some additional funcitons (like Alt codes)

Quickstart

This quickstart will show you all process of conversion Ducky Script to Arduino sketch

Requirements

To reproduce what is described here, you need to satisfy the following dependencies

• Python
• Arduino IDE
• Sublime Text (or another text editor)

download and install them to continue

Installation

Now you can install PotatoParser from PyPI packages using pip

pip install pparser

or the latest (but possibly unstable) from GitHub

pip install git+https://github.com/YariKartoshe4ka/PotatoParser.git

Processing

Let's write a test ducky script like this

REM Opens notepad and writing "Hello World!" 5 times
WINDOWS r
DELAY 200
STRING notepad.exe
ENTER
DELAY 500
STRING Hello World!
ENTER
REPEAT 4 2

And save it as test.ducky file. Now you can convert this script to valid Arduino sketch with the following command

pparser test.ducky

In current directory you can discover new folder sketch which contains Arduino sketch

Flashing

Open prepared sketch in Arduino IDE. Connect your board to PC and flash it. Make sure you have enabled NumLock on your keyboard. Upon completion, the script will start executing and, if you did everything correctly, you will see "Hello World!" printed 10 times in notepad. Here you can see the result (note that despite the current Russian layout ("РУС" = Russian), the text was printed in English):

example.mp4