Update 28 (Closes #21)

Co-authored-by: Jon <jon@mscreations.net>
Co-authored-by: xMasterX <10697207+xMasterX@users.noreply.github.com>

Firmwares.md

@@ -0,0 +1,94 @@
+<em>(Adapted from <a href="discord.com/users/597435984925294620">Nano&#39;s</a> <a href="https://discord.com/channels/937479784148115456/937489970007003166/970666146804170792">original</a> <a href="https://discord.com/channels/937479784148115456/937489970007003166/970666162247581806">messages</a> in the Unleashed firmware Discord.)</em>
+
+<h1>Flipper Zero firmware differences</h1>
+<h3>
+  <code>::</code> Last updated July 10 2022. <code>::</code>
+</h3>
+<p>This document will <em>(hopefully)</em> maintain a list of differences between various forks of the <a
+    href="#official">Flipper Zero firmware</a>. <br>If I had a dollar for every time I&#39;ve seen this question asked,
+  I wouldn&#39;t be in college debt. ¯\_(ツ)_/¯ <br>Also consider checking out the <a
+    href="https://github.com/djsime1/awesome-flipperzero">Awesome Flipper Zero list</a>, and my <a
+    href="https://gist.github.com/djsime1/73adaaf24f20b8bb70c4d4854431b0f1">rant about the two types of Flipper users</a>. </p>
+    <table><tr>
+      <td>
+        <strong>Jump to:</strong>
+      </td>
+      <td><a href="#official">Official</a></td>
+      <td><a href="#plugins">RogueMaster</a></td>
+      <td><a href="#unleashed">Unleashed</a></td>
+      <td><a href="#wetox">Wetox</a></td>
+      <td><a href="#muddledbox">MuddledBox</a></td>
+      <td><a href="#summary">Summary / TL; DR</a></td>
+    </tr></table>
+<h2 id="official">Official <kbd>
+    <a href="https://github.com/flipperdevices/flipperzero-firmware">flipperdevices/flipperzero-firmware</a>
+  </kbd>
+</h2>
+<ul>
+  <li>Has region-locked Sub-GHz transmission because of legal limitations.</li>
+  <li>Has no ability to save and send rolling codes (dynamic encrypted) in Sub-GHz, only shows them in captured list.
+  </li>
+  <li>Factory-set device name that shows everywhere (Bluetooth broadcast, USB connection, etc) can not be changed.</li>
+  <ul>
+    <li><em>The Flipper team has a list of device names with their corresponding production information <a href="https://discord.com/channels/740930220399525928/765282833744265246/971881286543224852">(No shipping address)</a> so they can assist you easier in case of an RMA.</em></li>
+  </ul>
+</ul>
+<h2 id="unleashed">Unleashed <kbd>
+    <a href="https://github.com/Eng1n33r/flipperzero-firmware">Eng1n33r/flipperzero-firmware</a>
+  </kbd>
+</h2>
+<ul>
+  <li><em>(AKA Code Grabber firmware.)</em></li>
+  <li>Very active development and Discord community.</li>
+  <li>Removes Sub-GHz regional transmission restrictions.</li>
+  <li>Adds extra Sub-GHz frequencies.</li>
+  <li>Adds extra mifare classic keys.</li>
+  <li>Can be used to capture and send dynamic encrypted protocols/rolling codes. <em>(Modern grage doors, car fobs,
+      etc.)</em></li>
+  <li>Encrypted Sub-GHz signals/codes can be manually added.</li>
+  <li><a href="https://github.com/Eng1n33r/flipperzero-firmware#current-modified-and-new-subghz-protocols-list">Current modified and new Sub-GHz protocols list</a>.</li>
+  <li>Comes with extra custom apps from community. <a href="https://github.com/Eng1n33r/flipperzero-firmware#apps-included">Apps List</a>.</li>
+  <li>Other small tweaks and changes.</li>
+</ul>
+<h2 id="plugins">RogueMaster <kbd>
+    <a href="https://github.com/RogueMaster/flipperzero-firmware-wPlugins">RogueMaster/flipperzero-firmware-wPlugins</a>
+  </kbd>
+</h2>
+<ul>
+  <li>Firmware with regional TX restriction removed.</li>
+  <li>Has Sub-GHz protocol changes copied from Unleashed FW.</li>
+  <li>Adds extra Sub-GHz frequencies.</li>
+  <li>Adds extra mifare classic keys.</li>
+  <li>Experimental Games only/DUMB mode.</li>
+  <li>Has some other small changes.</li>
+  <li>Most known community plugins & games have been added.</li>
+  <ul><li>Full list in their <a href="https://github.com/RogueMaster/flipperzero-firmware-wPlugins#readme">README</a>.</li></ul>
+</ul>
+<h2 id="wetox">Wetox <kbd>
+    <a href="https://github.com/wetox-team/flipperzero-firmware">wetox-team/flipperzero-firmware</a>
+  </kbd>
+</h2>
+<ul>
+  <li>The dev branch is intended for public use, while others are either testing or archived hackathon submissions.</li>
+  <li>Cracking T5577 RFID passwords via dictionary attack.</li>
+  <li>Desktop header branding [WTX].</li>
+  <li>Has some frequently updated interesting experimental stuff in different <a href="https://github.com/wetox-team/flipperzero-firmware/branches">branches</a>.</li>
+</ul>
+<h2 id="muddledbox">MuddledBox <kbd>
+    <a href="https://github.com/MuddledBox/flipperzero-firmware">MuddledBox/flipperzero-firmware</a>
+  </kbd>
+</h2>
+<ul>
+  <li><b>Abandoned. Not updated for more than 2 months.</b></li>
+  <li>Removes Sub-GHz regional transmission restrictions.</li>
+  <li>Adds self-promo images to about page in settings.</li>
+  <li>Adds a few extra common Sub-GHz frequencies to capture on.</li>
+</ul>
+<h2 id="summary">Summary <kbd>(TL; DR)</kbd></h2>
+<ul>
+  <li>Staying up to date with upstream (official) firmware is important.</li>
+  <li>TX restriction removal is illegal in most circumstances, use at your own risk.</li>
+  <li>MuddledBox was the first popular firmware fork, but didn't grow up.</li>
+  <li>Unleashed is more focused on the core functionality and Sub-GHz protocols, only stable community apps are included.</li>
+  <li>RogueMaster has more community plugins and other small changes.</li>
+</ul>

README.md

@@ -9,7 +9,7 @@
   <a href="#">
     <img src="https://awesome.re/badge.svg" alt="Awesome" height=24>
     <img src="https://img.shields.io/badge/Powered%20by-Dolphins-blue" alt="Powered by dolphins" height=24>
-    <img src="https://img.shields.io/badge/Approved%20by-Lurat-brightgreen" alt="Approved by Lurat" height=24 title="Lurat is my Flipper">
+    <img src="https://img.shields.io/badge/Approved%20by-Lurat-brightgreen" alt="Approved by Lurat" height=24 title="Lurat is the name of my Flipper">
     <img src="https://img.shields.io/badge/Hack-The%20Planet-orange" alt="Hack the planet" height=24>
   </a>
 </h3>
@@ -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
 
 <table align="right">
   <tr><th><strong>Hey you!</strong></th></tr>
-  <tr><td>🔰 <em><a href="https://gist.github.com/djsime1/edb8f3a0ab77e563898d1c55f489bf96">Click here</a> for a feature<br>comparison of these firmwares!</em></td></tr>
+  <tr><td>🔰 <em><a href="https://github.com/djsime1/awesome-flipperzero/blob/main/Firmwares.md">Click here</a> for a feature<br>comparison of these firmwares!</em></td></tr>
 </table>
 
 - [`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
 <table align="right">
@@ -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)