USB D-Byte Documantation

About USB D-Byte

USB D-Byte is a compact, powerful USB device that emulates a keyboard, similar to the USB Rubber Ducky and other BadUSB tools. Its sleek design, ease of use, and advanced features make payload deployment faster, smarter, and more flexible.

Key Features

• Plug & Play Script Deployment: Drag and drop payloads—no SD cards or WiFi needed.

• Dual Mode Operation: Switch between Attack Mode and Setup Mode.

• USB Mass Storage Support: Recognized as a USB flash drive for easy file management.

• Advanced Scripting Functions: New commands enhance payload flexibility.

• Multi-Language Keyboard Support: Compatible with various international keyboard layouts.

• HID Emulation: Acts as a USB keyboard and mouse, with boot keyboard support for BIOS access.

• Custom USB Identity: Modify VID, PID, serial number, manufacturer name, etc.

• Fully Open-Source: Source code and firmware available for customization.

• Built-in USB-A Connector: Plug directly into any USB-A port without adapters.

Specs USB D-Byte

• Dimensions: 38mm x 16.5mm x 6.5mm

• CPU: Dual-core 133 MHz 32-bit

• Storage: 4/8/16 MB SPI flash

• Switch: 2 Position Mode Switch (Attack & Setup)

• Connector: USB-A plug

• Buttons: Reset & boot button

Scripting: Basics

USB D-Byte's script language is compatible with Ducky Script (1.0), with added and expanded functions and keys. For a detailed Ducky Script reference, visit Hak5 Docs.

Basic Rules

• A single space separates keys.

• Keys on the same line are pressed and released simultaneously.

• Use STRING to write text.

• Case sensitivity matters.

Example Commands

• WINDOWS R: Press Windows key and R key simultaneously.

• STRING Hello World: Type "Hello World".

Example Script

REM Hello World Example Script
DEFAULTDELAY 200
DELAY 1000
GUI r
STRING notepad
ENTER
DELAY 1000
STRING Hello World!

Script Explanation

• REM This is a comment: Adds a comment.

• DEFAULTDELAY 200: Sets 200ms delay between lines.

• DELAY 1000: Waits 1 second.

• GUI r: Opens the Run window (Windows + R).

• STRING notepad: Types "notepad".

• ENTER: Launches Notepad.

• DELAY 1000: Waits 1 second.

• STRING Hello World!: Types "Hello World!" in Notepad.

Scripting: Functions

Below are key scripting functions for USB D-Byte.

Keyboard Layout

Set the default keyboard layout in preferences.json to avoid using LOCALE in scripts. Use LOCALE to change the keyboard layout for non-US keyboards to ensure correct character typing.

Example:

LOCALE DE
STRING Gänsefüßchen

Available Keyboard Layouts

Multi-Line Comments

Use ### for multi-line comments:

###
The quick brown
fox jumps over
the lazy dog
###

Large Strings

For long text, use LSTRING_BEGIN and LSTRING_END to type text with line breaks:

LSTRING_BEGIN
The quick brown
fox jumps over
the lazy dog
LSTRING_END

Loops

Use LOOP_BEGIN and LOOP_END for for-loop functionality:

LOOP_BEGIN 3
STRING Hello
DELAY 1000
STRINGLN World!
LOOP_END

Imports

Run another script using IMPORT for better script organization:

IMPORT second_script.txt

LED

Control the onboard LED with LED:

• Set color (R, G, B) and mode (SOLID, SLOW, FAST, OFF):

LED R SOLID
LED G SLOW
LED B FAST

• Set RGB values (0-255):

LED 42 13 37

• Add blink interval (ms):

LED 42 13 37 500

Custom Keycodes

Use KEYCODE to send specific keycodes, useful for keys not in the script language:

KEYCODE 0x02 0x04

• First argument: Modifier (e.g., shift, ctrl).

• Second argument: Up to 6 keys (decimal or hexadecimal).

Scripting: Keys

Standard Keys

a - z, A - Z, 0 - 9, F1 - F12

Modifier Keys

• CTRL or CONTROL

• SHIFT

• ALT

• GUI or WINDOWS or COMMAND

Other Keys

• ENTER

• MENU or APP

• DELETE

• HOME

• INSERT

• PAGEUP

• PAGEDOWN

• UP or UPARROW

• DOWN or DOWNARROW

• LEFT or LEFTARROW

• RIGHT or RIGHTARROW

• TAB

• END

• ESC or ESCAPE

• SPACE

• PAUSE or BREAK

• CAPSLOCK

• NUMLOCK

• PRINTSCREEN

• SCROLLLOCK

Numpad Keys

• NUM_0 - NUM_9

• NUM_ASTERIX

• NUM_ENTER

• NUM_MINUS

• NUM_DOT

• NUM_PLUS

Scripting: Mouse

Mouse Buttons

Preferences

The preferences.json file configures USB D-Byte's default behavior. Place it in the root directory of the device's storage.

Example preferences.json

{
  "$schema": "https://raw.githubusercontent.com/RDHRobotics/D-Byte/refs/heads/main/schema.json",
  "enable_msc": false,
  "enable_led": true,
  "enable_hid": true,
  "vid": "16D0",
  "pid": "11A4",
  "version": "0100",
  "serial": "1337",
  "manufacturer": "RDH Robotics",
  "product": "USB D-Byte",
  "default_layout": "US",
  "default_delay": 5,
  "main_script": "main_script.txt",
  "attack_color": [128, 0, 0, 0],
  "setup_color": [0, 0, 20, 0],
  "idle_color": [0, 30, 0, 0],
  "disable_capslock": true,
  "run_on_indicator": false,
  "initial_delay": 1000
}

Settings

Tip: Set default_layout in preferences.json to avoid specifying it in every script.

Credits

This project is based on USB Nova by SpacehuhnTech. Firmware and hardware are modified under MIT and CERN-OHL-P-2.0 licenses.

Thank you to the open-source community for making innovation accessible.

© 2025 RDH Robotics. All rights reserved.