Skip to content

A USB Rubber Ducky inspired device with a twist. This non-stealth version boasts an OLED and SD card for holding scripts.

Notifications You must be signed in to change notification settings

bill-23/bad-usb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Bad USB v1.1


Bad USB Installed

Ducky Script intrepter/executer for Arduino boards.

Designed as a non-stealth version of a usb rubber ducky Hak5 for times when stealth doens't matter and you want the ability to run any number of scripts.

The design incorporates an Arduino Pro Micro, Adafruit Micro-SD breakout, OLED Display and Mini Rotating Momentary Button.

Use this for LEGAL - NON NEFARIOUS uses - like automatically setting passwords or other IT tasks.

Released under MIT License


External Libraries

The script makes use of the following external libraries (All available from the Arduino library manager):

  • Keyboard
  • SPI
  • SD
  • Wire
  • ACROBOTIC_SSD1306

Note: We need to make a couple of changes to the ACROBOTIC_SSD1306 library. As of publishing time this project uses v1.0.1 which doens't seem to have native 128x32 support.

ACROBOTIC_SSD1306.h Change the SSD1306_Max_Y variable to SSD1306_Max_Y = 31.

ACROBOTIC_SSD1306.cpp Add sendCommand(SSD1306_Max_Y); to line 32 in init() Remove sendCommand(0x3F); from init()

Adjust the inner loop of clearDisplay() from i=16 -> i=26. This will clear the while screen. If not changed it will leave pixels lit even when cleared.


Hardware

  • Arduino Pro Micro - Amazon
  • Adafruit Micro-SD Breakout - Adafruit
  • OLED Display Module (128x32) - Amazon
  • 5 Way Momentary Push Button Switch - Amazon
  • OTG Adapter - Amazon
  • Micro-SD Card - Amazon

Wiring

  • Adafruit Micro-SD Breakout

    • CLK - Pin 15
    • D0 - Pin 14
    • D1 - Pin 16
    • CS - Pin 10
  • SSD1306 Display

    • SDA - Pin 2
    • SCL - Pin 3
  • Momentary Switch

    • Right - Pin 7
    • Center - Pin 8
    • Left - Pin 9
    • Side - GND

Sample Usage

To use, simply add Ducky Script .txt files to the micro-sd card and insert in the reader.

Once plugged in the root dir can be scrolled using the momentary switch. Once on the desired file press the momentary switch and the script will execute.

More info on Ducky Script syntax can be found here

HelloWorld.txt
REM This script will open notepad and type the string Hello, World!!!
DELAY 1000
REM Press the windows key, then type r 
GUI r
DELAY 500
ENTER
DELAY 500
REM Open Notepad
STRING notepad
DELAY 500
ENTER
DELAY 500
STRING Hello World!!!
ENTER

About

A USB Rubber Ducky inspired device with a twist. This non-stealth version boasts an OLED and SD card for holding scripts.

Topics

Resources

Stars

Watchers

Forks

Languages