Revision indexing in progress... (symbol navigation in revisions will be accurate after indexed)
-
1 + 2 + # The Ultimate Flipper Zero Badusb Collection 1 3 <img src="https://github.com/UNC0V3R3D/ressources/blob/main/badusbpic.png" height="380" width="1050" > 2 4 3 - # Badusb Collection for the FlipperZero 4 5 ![GitHub all releases](https://img.shields.io/github/downloads/UNC0V3R3D/Flipper_Zero-BadUsb/total?logo=GitHub) ![GitHub commit activity](https://img.shields.io/github/commit-activity/w/UNC0V3R3D/Flipper_Zero-BadUsb) ![GitHub repo size](https://img.shields.io/github/repo-size/UNC0V3R3D/Flipper_Zero-BadUsb) ![GitHub release (release name instead of tag name)](https://img.shields.io/github/v/release/UNC0V3R3D/Flipper_Zero-BadUsb?include_prereleases) 5 6 6 7 # Before you start! 7 8 8 - Before you start ``you have to agree`` with the "Usage Agreement" down below. This project ``is just for learning purposes``. Always ask for ``permission`` before running one of the scripts provided by me. I ``won't`` be responsible for any damage that you may cause. 9 + In order to begin, you ``must read and accept`` the usage agreement. **This project is for educational purposes only**! Please seek permission before running any of the scripts provided by me. I cannot be held responsible for any damage that may occur as a result of your use of these scripts. 9 10 If you want to purchase a completely unique and personalized script contact me on discord. 10 11 ![](header.png) 11 12 ## Installation skipped 1 lines 13 14 Windows: 14 15 15 16 ```sh 16 - 1. Download the latest Release. 17 - 2. Extract the files. 18 - 3. Use the qFlipper app to drag the files into the "BadUsb" folder on your Flipper. 17 + 1. git clone https://github.com/UNC0V3R3D/Flipper_Zero-BadUsb.git 18 + 19 + 2. Use the qFlipper app to drag the files into the "BadUsb" folder on your Flipper. 19 20 ``` 20 21 21 22 ## Usage example 22 23 23 - First, you can try out a few scripts on your own PC. 24 - Most scripts are relatively harmless, but you should first read the description in the respective file. 25 - Some scripts can also cause damage. Therefore, I am **NOT** responsible for any damage you cause. 24 + To begin using the scripts, ``please carefully read`` the "readme.md" file provided with each script. This file contains ``important information`` on how to use the script safely. Keep in mind that some scripts may ``potentially harm your system``, so be cautious and do not run unfamiliar scripts on your personal computer. To test scripts, it is recommended to ``use a virtual machine`` for safety. 26 25 27 26 ## Release History 28 27 skipped 23 lines 52 51 * v2.0 53 52 * Added ``DownLoadASCII`` and seperated ``Selfwriting`` Ascii 54 53 * Instant-download Ascii is about ``20x faster`` 54 + * v2.1 55 + * Added readme files for every script 56 + * Readme files contain ``important info`` about the script 57 + 55 58 56 59 ## Usage Agreement 57 60 58 - By using/downloading the scripts provided by UNC0V3R3D, 59 - you automatically agree to the following usage agreement. If you do not 60 - agree to all the terms of this agreement, you aren't allowed to use/download the scripts. 61 - 1. If you download and use the scripts provided by UNC0V3R3D, you agree that, UNC0V3R3D isn't responsible for your actions or any damage you cause. 62 - 2. You are allowed to share all of the files. 63 - 3. Copying the files without giving credits will lead to bad luck. 61 + By downloading and using the scripts provided by UNC0V3R3D, you are automatically agreeing to the following usage agreement. If you do not agree to the terms of this agreement, you are not permitted to download or use the scripts. 62 + 63 + 1. You acknowledge that UNC0V3R3D ``is not responsible`` for your actions or any damage you may cause as a result of using the scripts. 64 + 2. You are ``permitted`` to share all of the files. 65 + 3. You are ``allowed`` to modify the files, but are still responsible for your own actions. 64 66 65 67 66 68 # Instructions for newbies skipped 3 lines 70 72 ## Installation 71 73 72 74 ``` sh 73 - 1. Download the files directly from the repo or download the latest release. 75 + 1. Clone/Download the files directly from the repo or download the latest release. 74 76 2. Extract the files anywhere you like 75 - 3. Now you need to somehow get the files on your Flipper 76 - 4. If you are using a phone, just install the Flipper Zero mobile app. 77 - 5. If you are using a PC, just install the qFlipper app: https://flipperzero.one/update 78 - 6. Connect your Flipper via Bluetooth if you are using a phone, or connect it via usb if you are on PC. 79 - 7. Open qFlipper --> SD Card --> badusb --> Move the files here. 80 - 8. Now you are done with moving the files to your Flipper. 77 + 3. If you are using a phone, just install the Flipper Zero mobile app. 78 + 4. If you are using a PC, just install the qFlipper app: https://flipperzero.one/update 79 + 5. Connect your Flipper via Bluetooth if you are using a phone, or connect it via usb if you are on PC. 80 + 6. Open qFlipper --> SD Card --> badusb --> Move the files here. 81 + 7. Now you are done with moving the files to your Flipper. 81 82 ``` 82 83 83 84 ## Explanation of the files 84 85 85 - So now that you've moved the files to your Flipper, you first want to understand them before actually using them. 86 - If you're using the files from my BadUsb repository, 60% of the files are kind of harmless. 87 - But some files can actually be dangerous and cause serious damage, so be aware of that. 86 + Before using the files on your Flipper, it is important to thoroughly understand them. While the majority of the files in my BadUsb repository are relatively harmless, there are some that may potentially cause serious damage. It is important to exercise caution when using these files. 88 87 89 88 <h3> Understanding DuckyScript </h3> 90 89 91 - * All BadUsb-Scripts are written in the ``DuckyScript`` language. 90 + * All BadUsb-Scripts are written in the ``DuckyScript 1.0`` language. 92 91 * The language is kind of ``easy`` to understand and to learn. 93 92 * If you really want to look further into this please refer to this [Documentation]. 94 93 * The kind of ``hard part`` are the PowerShell scripts. skipped 31 lines 126 125 * ``1.1`` <b> The Flipper shows an error like this: ``ERROR: line 5`` </b> 127 126 * <em> If the Flipper prints random errors like this you should check the ``text file``. The most common thing causing this error is apparently a ``random blank line`` 128 127 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 no ``space`` at the beginning of the line. </em> 128 + 129 + * ``1.3`` <b> The Flipper shows an random overlayed error in line 1 </b> 130 + * <em> This is a new error/bug in the official firmware! To get around this error you will need to install an older version of the official firmware or switch to a third-party firmware like "Rogue Master". </em> 129 131 130 132 * I hope that you find a a solution for your problem. If you need help feel free to always contact me via Discord or Email. 131 133 skipped 9 lines 141 143 142 144 ## Meta 143 145 144 - 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. :) 146 + 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. :) 145 147 146 148 UNC0V3R3D – [@GitHub](https://github.com/UNC0V3R3D) – [email protected] 147 149 skipped 4 lines 152 154 153 155 ## Credits 154 156 155 - * [UberGuidoZ] and [FalsePhilosopher] 157 + * [UberGuidoZ] , [FalsePhilosopher] , [nocomp] and [I-am-Jakoby] 158 + * Make sure to check them out! They are the reason this repository exists. When I started learning how to create badusb scripts i learnt from them. 156 159 157 160 158 161 [release]: https://github.com/UNC0V3R3D/Flipper_Zero-BadUsb/releases 159 162 [UberGuidoZ]: https://github.com/UberGuidoZ 160 163 [FalsePhilosopher]: https://github.com/FalsePhilosopher 164 + [nocomp]: https://github.com/nocomp 165 + [I-am-Jakoby]: https://github.com/I-Am-Jakoby 161 166