Bad USB

Document image


Flipper Zero can act as a BadUSB device, recognized by computers as a Human Interface Device (HID), such as a keyboard. A BadUSB device can change system settings, open backdoors, retrieve data, initiate reverse shells, or basically do anything that can be achieved with physical access. It is done by executing a set of commands written in the Rubber Ducky Scripting Language, also known as DuckyScript. This set of commands is also called a payload.



On this page, you’ll learn about how BadUSB devices work and how to turn your Flipper Zero into one. Note that you can connect Flipper Zero to a computer not only via USB, but also via Bluetooth Low Energy (BLE).



Flipper Zero scripting language

Before using your Flipper Zero as a BadUSB device, you need to write a payload in the .txt format in any common ASCII text editor using the scripting language. Flipper Zero can execute extended Rubber Ducky script syntax. The syntax is compatible with the classic Rubber Ducky Scripting Language 1.0 but provides additional commands and features, such as the ALT+Numpad input method, SysRq command, and more.




Uploading new payloads to Flipper Zero

Once the payload is created, you can upload it to your Flipper Zero via qFlipper or Flipper Mobile App to the SD Card/badusb/ folder. The new payloads will be available in the Bad USB application.





Using your Flipper Zero as a BadUSB device

Via USB connection

To turn your Flipper Zero into a BadUSB device using USB, do the following:

1

If qFlipper is running on your computer, close it.

2

On your Flipper Zero, go to Main Menu -> Bad USB.

3

Select the payload and press the %ok%OK button.

4

Go to Config.

5

(Optional) If needed, you can modify the keyboard layout (US English is default).

6

Select connection type: USB.

7

Connect your Flipper Zero to the computer via a USB cable.

8

Press Run to execute the payload on the computer.



Via BLE сonnection

To turn your Flipper Zero into a BadUSB device using BLE, do the following:

1

Activate Bluetooth on your Flipper Zero by going to Main Menu -> Settings -> Bluetooth.

2

If qFlipper is running on your computer, close it.

3

On your Flipper Zero, go to Main Menu -> Bad USB.

4

Select the payload.

5

Go to Config.

6

(Optional) If needed, you can modify the keyboard layout (US English is default).

7

Select connection type: BLE.

8

Press %back%BACK.

9

On your computer, go to Bluetooth settings and connect to the detected wireless BadUSB device.

10

Confirm connection both on your computer and Flipper Zero (by selecting OK).

11

On your Flipper Zero, press Run to execute the payload on the computer.