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 underiButton
. - 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.
-
1.0
The script open random things and typed the text somewhere, where it shouldn't be.- So this is often caused by
too short delays
between the commands. In the BadUsb script file, you should see some commands, that start withDELAY
and then there is a number behind it.Example: DELAY 500
. The number stands formilliseconds
. Changing the delay to ahigher number
than the current number should solve the problem(DELAY 500 --> DELAY 700)
- So this is often caused by
-
1.1
The Flipper shows an error like this:ERROR: line 5
- If the Flipper prints random errors like this you should check the
text file
. The most common thing causing this error is apparently arandom blank line
between the commands. Otherwise, make sure there is no line containing the"LOCALE .."
command. It doesn't properly work on the Flipper, yeah I do not know why that is. If there is still an error, look at the line where the error is coming from and make sure there is nospace
at the beginning of the line.
- If the Flipper prints random errors like this you should check the
-
I hope that you have found a solution for your problem if you are reading this. If you need help feel free to always contact me via Discord or Email.
Meta
If you have any idea on how to make this Instruction to BadUsb scripts better feel free to open an Issue or contact me via Discord. :)