BadKB

Command syntax

BadKB app uses extended Duckyscript syntax. It is compatible with classic USB Rubber Ducky 1.0 scripts but provides some additional commands and features, such as custom USB ID, ALT+Numpad input method, SYSRQ command, and more functional keys.

Script file format

BadKB app can execute only text scrips from .txt files, no compilation is required. Both and \r line endings are supported. Empty lines are allowed. You can use spaces or tabs for line indentation.

Command set

Comment line

Just a single comment line. The interpreter will ignore all text after the REM command.

CommandParametersNotes

REM

Comment text

Delay

Pause script execution by a defined time.

CommandParametersNotes

DELAY

Delay value in ms

Single delay

DEFAULT_DELAY

Delay value in ms

Add delay before every next command

DEFAULTDELAY

Delay value in ms

Same as DEFAULT_DELAY

Special keys

CommandNotes

DOWNARROW / DOWN

LEFTARROW / LEFT

RIGHTARROW / RIGHT

UPARROW / UP

ENTER

DELETE

BACKSPACE

END

HOME

ESCAPE / ESC

INSERT

PAGEUP

PAGEDOWN

CAPSLOCK

NUMLOCK

SCROLLLOCK

PRINTSCREEN

BREAK

Pause/Break key

PAUSE

Pause/Break key

SPACE

TAB

MENU

Context menu key

APP

Same as MENU

Fx

F1-F12 keys

Modifier keys

Can be combined with a special key command or a single character.

CommandNotes

CONTROL / CTRL

SHIFT

ALT

WINDOWS / GUI

CTRL-ALT

CTRL+ALT

CTRL-SHIFT

CTRL+SHIFT

ALT-SHIFT

ALT+SHIFT

ALT-GUI

ALT+WIN

GUI-SHIFT

WIN+SHIFT

GUI-CTRL

WIN+CTRL

String

CommandParametersNotes

STRING

Text string

Print text string

String delay

Delay between keypresses.

CommandParametersNotes

STRING_DELAY

Delay value in ms

Applied once to next appearing string

STRINGDELAY

Delay value in ms

Same as STRING_DELAY

Repeat

CommandParametersNotes

REPEAT

Number of additional repeats

Repeat previous command

ALT+Numpad input

On Windows and some Linux systems, you can print characters by pressing ALT key and entering its code on Numpad.

CommandParametersNotes

ALTCHAR

Character code

Print single character

ALTSTRING

Text string

Print text string using ALT+Numpad method

ALTCODE

Text string

Same as ALTSTRING, presents in some Duckyscript implementations

SysRq

Send SysRq command

CommandParametersNotes

SYSRQ

Single character

USB device ID

You can set the custom ID of the Flipper USB HID device. ID command should be in the first line of script, it is executed before script run.

CommandParametersNotes

ID

VID:PID Manufacturer:Product

Example: ID 1234:abcd Flipper Devices:Flipper Zero

VID and PID are hex codes and are mandatory. Manufacturer and Product are text strings and are optional.

Last updated