DuckScriptInterpreter

KO | EN

gitlite — search

#python #hacktoberfest #typescript #golang #rust #docker #macos #windows #awesome-list #pytorch #security #ios #openai #open-source

DuckScriptInterpreter

(★ 18)

C++ interpreter for DuckScript3 and similar scripting languages

DuckScriptInterpreter 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DuckScriptInterpreter

DuckScriptInterpreter is a C++ interpreter for files written in a Ducky like language. It is intended for use as a library in embedded systems (e.g ESP32). As such the implementation of specific actions, such as turning LEDs on or pressing keys, needs to be provided by the caller. The interpreter is highly extendable, allowing users to define their own DuckyScript commands.

## Features
- Parses and executes Ducky-like script files.
- Designed for embedded systems.
- Easily extendable with user-defined functionality.
- Supports control flow constructs, repetition, functions, and extensions.
- Keyboard layouts

## Installation
To include DuckScriptInterpreter in your project, clone the repository and include the necessary files in your build system.

```sh
git clone https://github.com/i-am-shodan/DuckScriptInterpreter
cd DuckScriptInterpreter/example
chmod run.sh
./run.sh
```

## Usage
Include the DuckScriptInterpreter library in your project and implement the required hardware-specific functions.

### Supported Functionality
* DELAY
* STRING
* STRINGLN
* System keypresses (GUI, LSHIFT etc)
* WAIT_FOR_BUTTON_PRESS
* LED functions including LED_ON, LED_OFF, LED_R ,LEDG
* REM
* IF/ELSE IF
* VAR
* WHILE
* DEFINE
* ATTACKMODE
* RESTART_PAYLOAD
* RESET

### Supported keyboard layouts
The following layouts are currently support and are given in the format. \<OS>_\<Country code> or \<OS>_\<Locale>.

* win_be
* win_ca-FR
* win_ca
* win_ch
* win_cs-CZ
* win_de-DE
* win_da-DK
* win_en-GB
* win_es
* win_es-MX
* win_fi
* win_fr
* win_hr-HR
* win_hu-HU
* win_it
* win_ja-JP
* win_no
* win_pt-BR
* win_pt-PT
* win_ru
* win_se
* win_si
* win_sk-SK
* win_tr-TR

#### Note
Memory usage for devices that want to use this library is often at a premium. To reduce memory, in order to use these layouts they must first be 'compiled in'. Take your layout and replace the `-` character (if it exists) with `_` character then use that as a `#define`. For example to use win_en-GB I need to add the `#define win_en_GB` compiler directive.

### Planned Functionality but not yet implemented
* INJECT_MOD WINDOWS
* BUTTON_DEF
* DISABLE_BUTTON
* ENABLE_BUTTON
* RANDOM
* HOLD RELEASE
* STOP_PAYLOAD
* JITTER
* WAIT_FOR_CAPS_ON
* SAVE_HOST_KEYBOARD_LOCK_STATE

Unit tests are provided in the `tests/` directory. A simple example that can be run on a desktop machine is provided in the `example/` directory. This example demonstrates basic usage of the DuckScriptInterpreter library.

# License
This project is licensed under the MIT License. See the LICENSE file for details.

# Legal

For clarity this project is neither endorsed or supported by Hak5.

DuckScriptInterpreter

DuckScriptInterpreter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

DuckScriptInterpreter

DuckScriptInterpreter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README