Search…
Ducky Script Quick Reference
Ducky Script is the language of the USB Rubber Ducky. Writing scripts for can be done from any common ascii text editor such as Notepad, vi, emacs, nano, gedit, kedit, TextEdit, etc.

SYNTAX

Ducky Script syntax is simple. Each command resides on a new line and may have options follow. Commands are written in ALL CAPS, because ducks are loud and like to quack with pride. Most commands invoke keystrokes, key-combos or strings of text, while some offer delays or pauses. Below is a list of commands and their function, followed by some example usage.

REM

Similar to the REM command in Basic and other languages, lines beginning with REM will not be processed. REM is a comment.
1
REM The next three lines execute a command prompt in Windows
2
GUI r
3
STRING cmd
4
ENTER
Copied!

DEFAULT_DELAY OR DEFAULTDELAY

DEFAULT_DELAY or DEFAULTDELAY is used to define how long (in milliseconds * 10) to wait between each subsequent command. DEFAULT_DELAY must be issued at the beginning of the ducky script and is optional. Not specifying the DEFAULT_DELAY will result in faster execution of ducky scripts. This command is mostly useful when debugging.
1
DEFAULT_DELAY 10
2
REM delays 100ms between each subsequent command sequence
Copied!

DELAY

DELAY creates a momentary pause in the ducky script. It is quite handy for creating a moment of pause between sequential commands that may take the target computer some time to process. DELAY time is specified in milliseconds from 1 to 10000. Multiple DELAY commands can be used to create longer delays.
1
DELAY 50
2
REM will wait 500ms before continuing to the next command.
Copied!

STRING

STRING processes the text following taking special care to auto-shift. STRING can accept a single or multiple characters. STRING | a…z A…Z 0…9 !…) `~+=_-“‘;:<,>.?[{]}/|[email protected]#$%^&*()
1
GUI r
2
DELAY 50
3
STRING notepad.exe
4
ENTER
5
DELAY 100
6
STRING Hello World!
Copied!

WINDOWS OR GUI

Emulates the Windows-Key, sometimes referred to as the Super-key.
1
GUI r
2
REM will hold the Windows-key and press r, on windows systems resulting in the Run menu.
Copied!
Emulates the App key, sometimes referred to as the menu key or context menu key. On Windows systems this is similar to the SHIFT F10 key combo, producing the menu similar to a right-click.
1
GUI d
2
MENU
3
STRING v
4
STRING d
5
REM Switch to desktop, pull up context menu and choose actions v, then d toggles displaying Windows desktop icons
Copied!

SHIFT

Unlike CAPSLOCK, cruise control for cool, the SHIFT command can be used when navigating fields to select text, among other functions.
SHIFT | DELETE, HOME, INSERT, PAGEUP, PAGEDOWN, WINDOWS, GUI, UPARROW, DOWNARROW, LEFTARROW, RIGHTARROW, TAB
1
SHIFT INSERT
2
REM this is paste for most operating systems
Copied!

ALT

Found to the left of the space key on most keyboards, the ALT key is instrumental in many automation operations.
ALT | END, ESC, ESCAPE, F1…F12, Single Char, SPACE, TAB
1
GUI r
2
DELAY 50
3
STRING notepad.exe
4
ENTER
5
DELAY 100
6
STRING Hello World
7
ALT f
8
STRING s
9
REM alt-f pulls up the File menu and s saves. This two keystroke combo is why ALT is jealous of CONTROL's leetness and CTRL+S
Copied!

CONTROL OR CTRL

The king of key-combos, CONTROL is all mighty.
CONTROL | BREAK, PAUSE, F1…F12, ESCAPE, ESC, Single Char
CTRL | BREAK, PAUSE, F1…F12, ESCAPE, ESC, Single Char
1
CONTROL ESCAPE
2
REM this is equivalent to the GUI key in Windows
Copied!

ARROW KEYS

DOWNARROW or DOWN | | LEFTARROW or LEFT | | RIGHTARROW or RIGHT | | UPARROW or UP

EXTENDED COMMANDS

These extended keys are useful for various shortcuts and operating system specific functions and include:
1
BREAK or PAUSE
2
CAPSLOCK
3
DELETE
4
END
5
ESC or ESCAPE
6
HOME
7
INSERT
8
NUMLOCK
9
PAGEUP
10
PAGEDOWN
11
PRINTSCREEN
12
SCROLLOCK
13
SPACE
14
TAB
Copied!