🤬
Revision indexing in progress... (symbol navigation in revisions will be accurate after indexed)
  • ■ ■ ■ ■ ■ ■
    README.md
     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   
Please wait...
Page is in error, reload to recover