# Rucky
**Repository Path**: Moxin1044/Rucky
## Basic Information
- **Project Name**: Rucky
- **Description**: No description available
- **Primary Language**: Android
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-23
- **Last Updated**: 2021-12-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Rucky
[](https://github.com/mayankmetha/Rucky/blob/master/LICENSE)
[](https://mayankmetha.github.io/Rucky/)
[](https://github.com/mayankmetha/Rucky)
[](https://github.com/mayankmetha/Rucky)
[](https://github.com/mayankmetha/Rucky)
[](https://github.com/mayankmetha/Rucky)
---
# Status
## Build
[](https://github.com/mayankmetha/Rucky/actions/workflows/debug_build.yml)
[](https://github.com/mayankmetha/Rucky/actions/workflows/github_nightly_build.yml)
[](https://github.com/mayankmetha/Rucky/actions/workflows/github_release_build.yml)
[](https://github.com/mayankmetha/Rucky/actions/workflows/nethunter_build.yml)
## Code Analysis
[](https://github.com/mayankmetha/Rucky/actions/workflows/codeql-analysis.yml)
[](https://github.com/mayankmetha/Rucky/actions/workflows/mobsfscan_sarif.yml)
---
# Download
## GitHub
[](https://github.com/mayankmetha/Rucky/releases/latest)
[-blueviolet)](https://raw.githubusercontent.com/mayankmetha/Rucky/master/nightly/rucky-nightly.apk)
## Nethunter App Store
[](https://store.nethunter.com/en/packages/com.mayank.rucky/)
---
# 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](https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Duckyscript). 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](https://mayankmetha.github.io/Rucky-KeyMap/) 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_DELAY or STRINGDELAY
STRING processes the text following taking special care to auto-shift with additional delay between each character. STRING can accept a single or multiple characters.
Syntax:
Command | Delay Parameter | Parameter
:---: | :---: | :---:
STRING_DELAY | [num] | all possible printable characters supported on a specific keyboard layout
STRINGDELAY | [num] | all possible printable characters supported on a specific keyboard layout
Example:
```
STRING_DELAY 1000 hello world
STRINGDELAY 1000 hello world
```
### 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 connection detection
✅| Run attack UI button
✅| Auto launch attack on USB connect
✅| Auto launch 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
✅| Root detection
✅| Runtime process name masking
✅| Emulator detection
🚧| App anti-tamper detection
🚧| Anti-debug protection (Frida probe prevention)
❌| Disable app level virtualization (parallel app prevention)
❌| Memory dump prevention
💡| More feature addition on request
---
# Featuring Rucky
- [Kali Linux 2019.3 Release](https://www.kali.org/blog/kali-linux-2019-3-release/)
- [Kali Linux 2021.1 Release](https://www.kali.org/blog/kali-linux-2021-1-release/)
- [Prog.World](https://prog.world/kali-linux-nethunter-on-android-part-3-breaking-the-distance/)
- [ProgrammerSought](https://www.programmersought.com/article/30497171179/)
- [Dark_Mechanic YouTube Channel](https://youtu.be/ic-X-FCLNk8)
- [AV SHIVA NORO YouTube Channel](https://youtu.be/4clbu41cEQ0)
- [Android Infosec YouTube Channel](https://www.youtube.com/watch?v=_NDXzGPh_BQ)
- [Android Infosec Facebook Post](https://www.facebook.com/AndroidInfoSec/posts/4101537619869708)
---
# Legacy Work
[](https://github.com/mayankmetha/Rucky-Ext-RPi)
[](https://github.com/mayankmetha/Rucky-Legacy-HID)
[](https://github.com/mayankmetha/Rucky/releases/tag/1.9)
[](https://github.com/mayankmetha/Rucky/releases/tag/1.9)