diff --git a/README.md b/README.md index 39ca52c..d98705b 100644 --- a/README.md +++ b/README.md @@ -61,3 +61,11 @@ This is a two player game that uses the subghz_tx_rx worker library for communic ### subghz-samples-x10 [data](./subghz/samples/x10/README.md) - These Flipper Zero subghz captures are from the remote control for the X10. + +## Marauder +[tutorial](./marauder/README.md) - This is a tutorial on how to use the Marauder tool to attack 2.4GHz devices. + +[tool](./marauder/secret_ssid/README.md) - This is a tool that can be used to send a secret message over WiFi. The message is encoded into a SSID, which is then sent out over WiFi. The message can be decoded on a PC. + +## Support +[Buy me a coffee](https://ko-fi.com/codeallnight) - Thanks for supporting my work. diff --git a/marauder/README.md b/marauder/README.md new file mode 100644 index 0000000..ca536ed --- /dev/null +++ b/marauder/README.md @@ -0,0 +1,10 @@ +# Marauder +Marauder is a tool for hacking WiFi networks. It is a collection of tools that can be used to perform WiFi attacks. It is designed to be used with the [Flipper Zero](https://flipperzero.one/). + +[Official ESP32Marauder site](https://github.com/justcallmekoko/ESP32Marauder/wiki/Flipper-Zero) + +## Firmware +These are the [directions](./firmware/README.md) for updating the firmware on the ESP32. + +## Secret_ssid +This [secret_ssid](./secret_ssid/README.md) is a tool that can be used to send a secret message over WiFi. The message is encoded into a SSID, which is then sent out over WiFi. The message can be decoded on a PC. diff --git a/marauder/firmware/README.md b/marauder/firmware/README.md new file mode 100644 index 0000000..9301c02 --- /dev/null +++ b/marauder/firmware/README.md @@ -0,0 +1,18 @@ +# Marauder Firmware +To update your ESP32 firmware, you can use [ESP32Marauder](https://github.com/justcallmekoko/ESP32Marauder/wiki/Flipper-Zero) + +Talking Sasquach made a [video](https://youtu.be/uc5_hVmJ-3Y?t=354) that walks you through the process. +- Install Git & Python3. +- Install the "[CP210x Universal Windows Driver](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads)" from Silicon Labs. +- Open PowerShell +- git clone https://github.com/SkeletonMan03/FZEasyMarauderFlash +- cd FZEasyMarauderFlash +- run `pip3 install -r requirements.txt`. +- Connect the devboard or ESP32 board via USB. +- Press and hold the `BOOT` button on the module, press and release the `RESET` button. +- Release the BOOT button. +- run `python3 EasyInstall.py`. +- Select the option of what you want to do + - I choose "Update all files" + - then I choose "Flash Marauder on ESP32-WROOM" for the WROOM module. + - or "Flash Marauder on ESP32 Wemos D1 Mini" for the D1 Mini module. diff --git a/marauder/secret_ssid/README.md b/marauder/secret_ssid/README.md index b235076..c99d665 100644 --- a/marauder/secret_ssid/README.md +++ b/marauder/secret_ssid/README.md @@ -4,7 +4,7 @@ *secret_ssid* allows you to pass short *secret messages* using SSIDs. For example, you can tell someone nearby your burner phone number or YouTube link. ## Typical usage -Let's says you needed to tell a friend the A-Team's mobile phone number is "5556162". Rather than write it on a napkin at a hotdog stand, you can walk into the coffee shop and use Marauder on your Flipper zero to do a *Beacon spam* with any of the following SSIDs: AL6fvOPr, BOI5O5Ag, CRU3Cjn7 or DUgPtAbN. If you think someone is carefully watching the SSIDs, can you use an expanded ssid format like "ATTCRU3Cjn7", so it looks just like an AT&T router. +Let's say you needed to tell a friend the A-Team's mobile phone number is "5556162". Rather than write it on a napkin at a hotdog stand, you can walk into the coffee shop and use Marauder on your Flipper zero to do a *Beacon spam* with any of the following SSIDs: AL6fvOPr, BOI5O5Ag, CRU3Cjn7 or DUgPtAbN. If you think someone is carefully watching the SSIDs, can you use an expanded ssid format like "ATTCRU3Cjn7", so it looks just like an AT&T router. Your friend just needs to run the PowerShell script on their laptop to get your message. They don't even need to buy a Flipper -- which might help them save enough to _hire the A-Team_. diff --git a/plugins/basic_scenes/README.md b/plugins/basic_scenes/README.md index 7fd78d5..58faaca 100644 --- a/plugins/basic_scenes/README.md +++ b/plugins/basic_scenes/README.md @@ -41,6 +41,8 @@ Our application will have the following scenes: A module (or more specifically, a module's view) will display the user interface on the Flipper Zero. It will also handle the user input. +For a list of all of the modules available in applications/services/gui, please see [A Visual Guide to Flipper Zero GUI Components](https://brodan.biz/blog/a-visual-guide-to-flipper-zero-gui-components/) over on brodan.biz/blog. + Our application will use the following modules: - submenu - The submenu module (for displaying the main menu)