Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yarikartoshe4ka/potatoparser
Converter of Ducky Script to Arduino sketch with some additional funcitons (like Alt codes)
https://github.com/yarikartoshe4ka/potatoparser
arduino ducky hid parser pentest-tool python3 rubber-ducky
Last synced: about 1 month ago
JSON representation
Converter of Ducky Script to Arduino sketch with some additional funcitons (like Alt codes)
- Host: GitHub
- URL: https://github.com/yarikartoshe4ka/potatoparser
- Owner: YariKartoshe4ka
- License: gpl-3.0
- Created: 2020-06-03T07:04:38.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-07-09T10:20:04.000Z (over 2 years ago)
- Last Synced: 2024-10-13T02:04:31.838Z (about 1 month ago)
- Topics: arduino, ducky, hid, parser, pentest-tool, python3, rubber-ducky
- Language: Python
- Homepage: https://pparser.readthedocs.io
- Size: 494 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## PotatoParser
Converter of Ducky Script to Arduino sketch with some additional funcitons (like Alt codes)
[](https://pypi.org/project/pparser/)
[](https://pparser.readthedocs.io)
[](https://github.com/YariKartoshe4ka/PotatoParser/releases)
# 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](https://www.python.org/downloads/)
- [Arduino IDE](https://www.arduino.cc/en/software)
- [Sublime Text](https://www.sublimetext.com/download) (or another text editor)
download and install them to continue
### Installation
Now you can install [PotatoParser](https://pypi.org/project/pparser/) from PyPI packages using pip
```bash
pip install pparser
```
or the latest (but possibly unstable) from GitHub
```bash
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
```bash
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**):
https://user-images.githubusercontent.com/49284924/148426223-d6935708-9a0b-4523-ad12-71c63402a12f.mp4