Instructions for newbies

In this quick instruction you are going to learn how to setup the scripts and use them properly. If you have any questions after reading this instruction, just DM me on Discord (UNC0V3R3D#8662).

Installation

1. Download the files directly from the repo or download the latest release.
2. Extract the files anywhere you like
3. Now you need to somehow get the files on your Flipper
4. If you are using a phone, just install the Flipper Zero mobile app.
5. If you are using a PC, just install the qFlipper app: https://flipperzero.one/update
6. Connect your Flipper via Bluetooth if you are using a phone, or connect it via usb if you are on PC.
7. Open qFlipper --> SD Card --> badusb --> Move the files here.
8. Now you are done with moving the files to your Flipper.

Explanation of the files

So now that you've moved the files to your Flipper, you first want to understand them before actually using them. If you're using the files from my BadUsb repository, 60% of the files are kind of harmless. But some files can actually be dangerous and cause serious damage, so be aware of that.

Understanding DuckyScript

All BadUsb-Scripts are written in the DuckyScript language.
The language is kind of easy to understand and to learn.
If you really want to look further into this please refer to this Documentation.
The kind of hard part is the PowerShell scripts.
We use PowerShell or PowerShell scripts in 97% of all DuckyScripts.
PowerShell or PowerShell scripts give us full power over the machine.
If you want to learn how to write PowerShell scripts after learning the DuckyScript basics please refer to this PowerShell-Guide.
In 90% of all BadUsb scripts, you will find comments every few lines, that start with the command REM at the beginning.
Those comments often explain the whole process and help you a lot.
That's how you understand certain BadUsb scripts, but you can also often already identify the script by its file name.

Using the scripts properly

So now that we have prepared everything, we can start to test our first script!
We are going to run the first script on our own PC.
Of course, you don't want to cause damage to your PC, so we are going to choose a harmless script.
Let's choose a script that will draw something in the Notepad.
I chose a script from my ASCII repository.
If you want to open the text file on your phone or pc to see what is inside feel free to do so.
To start you are going to start the Flipper and find the Bad USB category located directly under iButton.
There you will see all the scripts you have imported from your PC or phone.
Now choose a harmless script and wait until the Flipper tells you to connect to a PC via the USB cable.
Just press the middle button to start the script.
Now the script should open Notepad and write a simple sentence "Hacked by UNC0V3R3D".
If you succeeded congrats! You have just run your very first script.
If something went wrong then please scroll further down to see the Troubleshooting section and follow the steps.

Troubleshooting Problems

First of all, you have to identify the problem. Then you can look at the list below and maybe you will recognize your problem.