diff --git a/Firmwares.md b/Firmwares.md
new file mode 100644
index 0000000..2aefaee
--- /dev/null
+++ b/Firmwares.md
@@ -0,0 +1,94 @@
+(Adapted from Nano's original messages in the Unleashed firmware Discord.)
+
+Flipper Zero firmware differences
+
+ :: Last updated July 10 2022. ::
+
+This document will (hopefully) maintain a list of differences between various forks of the Flipper Zero firmware.
If I had a dollar for every time I've seen this question asked,
+ I wouldn't be in college debt. ¯\_(ツ)_/¯
Also consider checking out the Awesome Flipper Zero list, and my rant about the two types of Flipper users.
+
+
+
+ - Has region-locked Sub-GHz transmission because of legal limitations.
+ - Has no ability to save and send rolling codes (dynamic encrypted) in Sub-GHz, only shows them in captured list.
+
+ - Factory-set device name that shows everywhere (Bluetooth broadcast, USB connection, etc) can not be changed.
+
+ - The Flipper team has a list of device names with their corresponding production information (No shipping address) so they can assist you easier in case of an RMA.
+
+
+
+
+ - (AKA Code Grabber firmware.)
+ - Very active development and Discord community.
+ - Removes Sub-GHz regional transmission restrictions.
+ - Adds extra Sub-GHz frequencies.
+ - Adds extra mifare classic keys.
+ - Can be used to capture and send dynamic encrypted protocols/rolling codes. (Modern grage doors, car fobs,
+ etc.)
+ - Encrypted Sub-GHz signals/codes can be manually added.
+ - Current modified and new Sub-GHz protocols list.
+ - Comes with extra custom apps from community. Apps List.
+ - Other small tweaks and changes.
+
+
+
+ - Firmware with regional TX restriction removed.
+ - Has Sub-GHz protocol changes copied from Unleashed FW.
+ - Adds extra Sub-GHz frequencies.
+ - Adds extra mifare classic keys.
+ - Experimental Games only/DUMB mode.
+ - Has some other small changes.
+ - Most known community plugins & games have been added.
+
+
+
+
+ - The dev branch is intended for public use, while others are either testing or archived hackathon submissions.
+ - Cracking T5577 RFID passwords via dictionary attack.
+ - Desktop header branding [WTX].
+ - Has some frequently updated interesting experimental stuff in different branches.
+
+
+
+ - Abandoned. Not updated for more than 2 months.
+ - Removes Sub-GHz regional transmission restrictions.
+ - Adds self-promo images to about page in settings.
+ - Adds a few extra common Sub-GHz frequencies to capture on.
+
+Summary (TL; DR)
+
+ - Staying up to date with upstream (official) firmware is important.
+ - TX restriction removal is illegal in most circumstances, use at your own risk.
+ - MuddledBox was the first popular firmware fork, but didn't grow up.
+ - Unleashed is more focused on the core functionality and Sub-GHz protocols, only stable community apps are included.
+ - RogueMaster has more community plugins and other small changes.
+
diff --git a/README.md b/README.md
index 6ac6f4f..28fbfad 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
- 
+
@@ -24,7 +24,7 @@
- [`Flipper Maker` Generate Flipper Zero files on the fly.](https://flippermaker.github.io/)
- [`FlipperAmiibo` Bank vault of Amiibos to Flipper's format.](https://github.com/Gioman101/FlipperAmiibo)
- [`FlipperMusicRTTTL` Collection of musics for FlipperZero Music Player.](https://github.com/neverfa11ing/FlipperMusicRTTTL)
-- [`Generic BadUSB Payloads` Hak5 Duckyscript payloads.](https://github.com/hak5/usbrubberducky-payloads)
+- [`Generic BadUSB Payloads` Hak5 Duckyscript payloads.](https://github.com/nocomp/Flipper_Zero_Badusb_hack5_payloads)
- [`Flipper BadUSB Payloads` Collection of payloads formatted to work on the Flipper Zero.](https://github.com/I-Am-Jakoby/Flipper-Zero-BadUSB)
- [`FlipperZero-Goodies` Intercom keys, scripts, etc.](https://github.com/wetox-team/flipperzero-goodies)
@@ -41,18 +41,20 @@
- [`Flappy Bird` The name says it all.](https://github.com/DroomOne/flipperzero-firmware/tree/dev/applications%2Fflappy_bird)
- [`Mouse jiggler` Keeps PC screens on by acting as a moving mouse.](https://github.com/MuddledBox/flipperzero-firmware/tree/Mouse_Jiggler/applications/mouse_jiggler)
- [`floopper-bloopper` LD#47 Game.](https://github.com/glitchcore/floopper-bloopper)
+- [`NRF24 & Mousejacking` PoC NRF24 library and mousejack exploitation app.](https://github.com/mothball187/flipperzero-nrf24)
## Firmwares & Tweaks
| Hey you! |
|---|
- 🔰 Click here for a feature
comparison of these firmwares! |
+ 🔰 Click here for a feature
comparison of these firmwares! |
- [`Firmware with plugins` Frequency-unlocked firmware with assorted community plugins.](https://github.com/RogueMaster/flipperzero-firmware-wPlugins)
- [`Unleashed` Active firmware without legal limitations.](https://github.com/Eng1n33r/flipperzero-firmware)
- [`Muddled Forks` Less-active firmware modifications.](https://github.com/MuddledBox/flipperzero-firmware/tree/muddled_dev)
- [`Wetox` Very similar to the official branch, with a few small tweaks.](https://github.com/wetox-team/flipperzero-firmware)
+- [`OpenHaystack BLE mod` Very old PoC that makes Flipper behave like an AirTag.](https://github.com/AlexStrNik/flipperzero-firmware)
## Modules & Cases
- [`FlipperZero-Hardware` 3D-Printable cases with custom iButton interface.](https://github.com/s0ko1ex/FlipperZero-Hardware)
@@ -74,6 +76,7 @@
- [`Flipper File Toolbox` Scripts for generating Flipper data files.](https://github.com/evilpete/flipper_toolbox)
- [`Marauder for Wifi Dev Board` See Flipper.bin in Releases by JustCallMeKoko.](https://github.com/justcallmekoko/ESP32Marauder)
- [`VertProntoIR2FlipperIR` Converts Vert Pronto IR codes to Flipper format.](https://github.com/SkeletonMan03/VertProntoIR2FlipperIR)
+- [`FlippMibo` Yet another Amiibo to Flipper conversion script.](https://github.com/0xz00n/FlipMiibo)
## Notes & References
@@ -83,7 +86,7 @@
- [`Official battery self-repair guide` How to troubleshoot battery issues.](https://cdn.flipperzero.one/self-repair-guide.pdf)
- [`Official firmware recovery guide` How to troubleshoot firmware issues.](https://docs.flipperzero.one/basics/firmware-update/firmware-recovery)
-- [`FZ Firmware Comparisons` Comparison of custom firmwares listed in this repo.](https://gist.github.com/djsime1/edb8f3a0ab77e563898d1c55f489bf96)
+- [`FZ Firmware Comparisons` Comparison of custom firmwares listed in this repo.](https://github.com/djsime1/awesome-flipperzero/blob/main/Firmwares.md)
- [`Flipper Zero Hacking 101` Guides with screenshots, files, and general help.](https://flipper.pingywon.com/)
- [`Reset forgotten PIN` How to reset your device's PIN code.](https://gist.github.com/djsime1/18d73b981249859f17aab3e2bfd2b600)
- [`Atmanos Flipper Software Docs` Flipper development tutorials and information.](https://flipper.atmanos.com/docs/overview/intro)
@@ -91,7 +94,7 @@
- [`Firmware roadmap` Official stock firmware roadmap.](https://miro.com/app/board/uXjVO_3D6xU=/?moveToWidget=3458764522498020058&cot=14)
- [`Flipper Zero SW&HW keynote` (OUTDATED) Hardware & software architecture document.](https://miro.com/app/board/o9J_l1XZfbw=/?moveToWidget=3458764514405659414&cot=14)
- [`Unofficial Community Wiki` To help consolidate all things Flipper (official and unofficial).](https://flipperzero.miraheze.org/wiki/Main_Page)
-- [`Flipper Zero disassembly guide` Difficulty: Moderate, Time: 8-15 Minutes.](https://www.ifixit.com/Guide/Flipper+Zero+Disassembly/151331)
+- [`Flipper Zero disassembly guide` Difficulty: Moderate, Time: 8-15 Minutes.](https://www.ifixit.com/Guide/Flipper+Zero+Disassembly/151455)
- [`Alternative disassembly video` Third-party video for disassembling the Flipper.](https://youtu.be/38pHe7M4vl8)
- [`ESP32 Marauder on WiFi dev board` Portable WiFi/Bluetooth pentesting.](https://github.com/justcallmekoko/ESP32Marauder/wiki/flipper-zero)
- [`ESP32 Marauder guide video` Companion video for the above link.](https://youtu.be/_YLTpNo5xa0)