Skip to content

Bad USB ​

The Bad USB app turns the Flipper into a keyboard (and mouse) that types a prepared script into a computer. The computer sees an ordinary Human Interface Device (HID), so no drivers are needed. Scripts are written in an extended DuckyScript (the language of the USB Rubber Ducky) and stored as plain .txt files on the microSD card.

Bad USB

Typical legitimate uses: automating repetitive setup on your own machines, typing long passwords or configs, installing software on a fresh PC, demos and security awareness training.

Legal

A keystroke-injection device can do anything a person at the keyboard can. Only run scripts on computers you own or are explicitly allowed to test.

The app works over USB cable or over Bluetooth (BLE), the latter appears to the host as a Bluetooth keyboard.

Unleashed

Unleashed integrates BadKB (by Willy-JL, ClaraCrazy and XFW contributors) right into the Bad USB app:

  • BLE mode with configurable device name, MAC address, pairing mode and persistent pairing, plus the BLE_ID / BT_ID script commands;
  • USB identity settings: manufacturer and product name, VID/PID, randomisation;
  • keyboard layouts for many languages (by rien / dummy-decoy);
  • the DUCKY_LANG command, so a script can choose its own keyboard layout (new in the current release, PR #1224 by @ANTONiO-eagle).

Files ​

PathContent
/ext/badusb/Your scripts (.txt). The app's file browser opens here.
/ext/badusb/examples/Demo scripts shipped with the firmware (Windows, macOS, GNOME, ChromeOS, mouse test, qFlipper installers).
/ext/badusb/assets/layouts/Keyboard layout files (.kl). See Keyboard layouts.
/ext/badusb/.badusb.settingsApp settings: global layout, USB/BLE mode, USB and BLE identity.

Upload scripts with qFlipper, the mobile app or by copying them to the SD card. A file with the same name is overwritten without warning.

Pages in this section ​

PageWhat you learn
Using Bad USBRunning scripts over USB and BLE, the Config menu, all settings
Script formatFull command reference: STRING, DELAY, HOLD/RELEASE, ALTCHAR, MEDIA, mouse, ID, DUCKY_LANG…
ExamplesSafe example scripts to start with
Keyboard layoutsWhich layouts exist, how they work, choosing one per script

Not affiliated with Flipper Devices. For educational and lawful use only.