Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Oct 3, 2021
app
Oct 3, 2021
Oct 3, 2021
Aug 28, 2021
0
Jun 13, 2021
May 22, 2020
Oct 3, 2021
Oct 3, 2021
Feb 6, 2021
Feb 6, 2021

Rucky

GitHub Crowdin Android Architecture Kernel <=3.18 Kernel >=3.19


Status

Build

Debug Build Github Nightly Build Github Release Build Nethunter Build

Code Analysis

CodeQL mobsfscan sarif


Download

GitHub

GitHub release (latest by date) Github nightly

Nethunter App Store

Nethuter Release


Readme

An android app to perform USB HID Attacks (Rubber Duck) in multiple ways:

  • Wired Mode: Needs a custom kernel with usb hid feature or a kernel with configfs to be enabled for this mode to be used.
  • Wireless: Provides a socket server to extend this USB HID with external tools/hardwares like raspberry pi, socket services, nc, and much more.

Ducky Script

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. Some syntax extended from the original Hak5 Ducky Script Syntax. Mouse ducky scripts are different from those seen online and have been defined to keep the similarity with the keyboard ducky scripts.

Note: In parameters [num] represents a number, [char] represents characters A-Z, a-z. Customizable HID support too has been added.

Keyboard

DEFAULTDELAY or DEFAULT_DELAY

DEFAULT_DELAY or DEFAULTDELAY is used to define how long (milliseconds) 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.

Syntax:

Command Parameter
DEFAULTDELAY or DEFAULT_DELAY [num]

Example:

DEFAULTDELAY 100
DEFAULT_DELAY 100

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. Multiple DELAY commands can be used to create longer delays.

Syntax:

Command Parameter
DELAY [num]

Example:

DELAY 500

REM

Similar to the REM command in Basic and other languages, lines beginning with REM will not be processed. REM is a comment.

Syntax:

Command Parameter
REM comment string

Example:

REM This is a comment

REPEAT

Repeats the last command [num] times

Syntax:

Command Parameter
REPEAT [num]

Example:

DELAY 1
REPEAT 5

STRING

STRING processes the text following taking special care to auto-shift. STRING can accept a single or multiple characters.

Syntax:

Command Parameter
STRING all possible printable characters supported on a specific keyboard layout

Example:

STRING hello world

GUI or WINDOWS or COMMAND or META

Emulates the Windows-Key, sometimes referred to as the Super-key.

Syntax:

Command Parameter
GUI or WINDOWS or COMMAND or META Combo Key

Example:

GUI r

SHIFT

Unlike CAPSLOCK, cruise control for cool, the SHIFT command can be used when navigating fields to select text, among other functions.

Syntax:

Command Optional Parameter Parameter
SHIFT ALT or GUI or WINDOWS or COMMAND or META or CTRL or CONTROL Combo Key

Example:

SHIFT a
SHIFT ALT 4

ALT

Found to the left of the space key on most keyboards, the ALT key is instrumental in many automation operations.

Syntax:

Command Optional Parameter Parameter
ALT SHIFT or CTRL or CONTROL Combo Key

Example:

ALT a
ALT SHIFT e

CONTROL or CTRL

The king of key-combos, CONTROL is all mighty.

Syntax:

Command Optional Parameter Parameter
CTRL or CONTROL SHIFT or ALT Combo Key

Example:

CTRL s
CTRL ALT DELETE

Extended Keys

These keys have no parameters.

Syntax:

Command Description
MENU or APP 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. Has no parameters
DOWNARROW or DOWN Emulates down arrow key
UPARROW or UP Emulates down arrow key
LEFTARROW or LEFT Emulates left arrow key
RIGHTARROW or RIGHT Emulates right arrow key
DELETE Emulates delete key
END Emulates end key
HOME Emulates home key
INSERT Emulates insert key
PAGEUP Emulates page up key
PAGEDOWN Emulated page down key
PRINTSCREEN or PRINTSCRN or PRNTSCRN or PRTSCN or PRSC or PRTSCR Typically takes screenshots
BREAK or PAUSE For the infamous combo CTRL BREAK
NUMLOCK Toggle numlock
CAPSLOCK Toggle capslock
SCROLLLOCK Toggle scroll lock
ESC or ESCAPE Emulates esc key
SPACE Emulates spacebar
TAB Emulates tab key
BACKSPACE or BKSP Emulates backspace key. On MacOS this is the delete key.
ENTER Emulates enter key
F1 Emulates F1 key
F2 Emulates F2 key
F3 Emulates F3 key
F4 Emulates F4 key
F5 Emulates F5 key
F6 Emulates F6 key
F7 Emulates F7 key
F8 Emulates F8 key
F9 Emulates F9 key
F10 Emulates F10 key
F11 Emulates F11 key
F12 Emulates F12 key
F13 Emulates F13 key
F14 Emulates F14 key
F15 Emulates F15 key
F16 Emulates F16 key
F17 Emulates F17 key
F18 Emulates F18 key
F19 Emulates F19 key
F20 Emulates F20 key
F21 Emulates F21 key
F22 Emulates F22 key
F23 Emulates F23 key
F24 Emulates F24 key

Combo Key

Some commands has a parameter which is a combo key. These keys belong to US English keyboard. List of supported combo key are:

  • ESCAPE or ESC
  • ENTER
  • SPACE
  • BACKSPACE or BKSP
  • TAB
  • INSERT
  • DELETE
  • PAGEUP
  • PAGEDOWN
  • HOME
  • END
  • DOWNARROW or DOWN
  • UPARROW or UP
  • LEFTARROW or LEFT
  • RIGHTARROW or RIGHT
  • BREAK or PAUSE
  • F1 to F24
  • single number [num]
  • Single character [char]
  • ` or ~
  • [ or {
  • ] or }
  • \ or |
  • ; or :
  • , or <
  • . or >
  • / or ?
  • - or _
  • = or +

Mouse/Pointer

MOUSE or POINTER

All mouse/pointer commands will start with this command. REPEAT command and DELAY commands effect can also be applied to mouse commands.

Note:

  1. In parameter field [button], which emulates a mouse button action and can have the following value:
    • LEFT
    • RIGHT
    • MIDDLE
  2. In parameter field [x] and [y], which emulates mouse movement action and can have the value range from -127 to 127. This represents pixels and is relative to where the mouse currently is. If you are at the point (150,150) then you can move the mouse to (127,127) pixels of this point followed by (23,23). Therefore, if the mouse is at (0,0) [top left corner] and you want to move to (1920, 1080) [bottom right corner, assuming a 1080p display], then you would need to move the mouse a few times 127 pixels at a time (or less) in either direction.
  3. In parameter field [scroll], which emulates mouse scroll whell action and can have the following value:
    • UP
    • DOWN
  4. In parameters [num] represents a number. This is used to repeat the action. Alternatively, REPEAT command can be used.

Syntax:

Command Command Type Parameter 1 Parameter 2 Parameter 3 Parameter 4 Description
MOUSE or POINTER CLICK or TOUCH or PRESS [button] [num] Mouse button click. Mouse does not move along [x] and [y] directions.
MOUSE or POINTER HOLD or DRAG [button] [x] [y] [num] Mouse button click and hold. Mouse can be moved along [x] and [y] directions.
MOUSE or POINTER MOVE or TRANSLATE [x] [y] [num] Mouse button does not click. Mouse can be moved along [x] and [y] directions.
MOUSE or POINTER KNOB or WHEEL or SCROLL [scroll] [num] Mouse button does not click. Mouse can be scrolled up or down.

Example:

REM double left click
MOUSE CLICK LEFT 2
REM drag a folder
MOUSE HOLD LEFT 127 45
REM move pointer
MOUSE MOVE 0 0 5
REM scroll a document
MOUSE SCROLL DOWN 10
REM using repeat
MOUSE CLICK LEFT
REPEAT 1

Localization

Code Language Translated
ar Arabic 100%
az Azerbaijani 100%
b+ber Berber 19%
b+sat Santali 29%
bg Bulgarian 100%
br Breton 6%
cs Czech 100%
da Danish 100%
de German 100%
el Greek 100%
en-rGB English (UK) 100%
en-rUS English (US) 100%
es Spanish 100%
et Estonian 100%
eu Basque 4%
fa Persian 5%
fi Finnish 100%
fr French 100%
hi Hindi 100%
hr Croatian 100%
hu Hungarian 16%
in Indonesian 100%
it Italian 100%
is Icelandic 0%
iw Hebrew 100%
ja Japanese 100%
ko Korean 100%
ku Kurdish 1%
lt Lithuanian 100%
lv Latvian 100%
ms Malay 100%
nb Norwegian Bokmal 100%
nl Dutch 100%
no Norwegian 100%
pl Polish 100%
pt Portuguese 100%
ro Romanian 100%
ru Russian 100%
sk Slovak 100%
sl Slovenian 100%
sv Swedish 100%
ta Tamil 100%
te Telugu 100%
th Thai 100%
tr Turkish 100%
uk Ukrainian 100%
ur-rIN Urdu (IN) 100%
ur-rPK Urdu (PK) 100%
vi Vietnamese 100%
zh-rCN Chinese Simplified 100%
zh-rTW Chinese Traditional 100%

Features

Status Feature
USB HID (Root & custom kernel required)
USB HID over network socket
USB HID over bluetooth
USB connection detection
Run attack UI button
Autolaunch attack on USB connect
Autolaunch attack on network socket connect
Save scripts
Load scripts
Delete scripts
Day/Night theme
Customize accent colours
Launch app via dialer app
Hide launcher app (till Android 10)
Disable app launch via launcher (Android 11 onwards)
Biometric support
App lock support
Encrypt scripts on save
Decrypt scripts on load
Customize network socket address
In-app update service (GitHub release only)
Kali Linux NetHunter Support
Nightly Builds
ConfigFS auto configuration
Multiple HID languages support
Customizable HID for additional language support
Platform independent HID support
Can attack virtually any system with USB HID support
USB HID mouse support
Disable app level virtualization (parallel app prevention)
App anti-tamper detection
Runtime process name masking
Memory dump prevention
Anti-debug protection (Frida probe prevention)
💡 More feature addition on request

Featuring Rucky


Legacy Work

RPi HID Android Android