diff --git a/FAQ.md b/FAQ.md
index de7ae138..aad77a99 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -29,11 +29,15 @@
### What is Awesome Flipper Zero?
> It's an [Awesome List](https://github.com/sindresorhus/awesome/blob/main/awesome.md) that I ([djsime1](https://dj.je)) created shortly after receiving Lurat, my lovely dolphin sidekick.
+### What is an Awesome List?
+> An [Awesome List](https://github.com/sindresorhus/awesome/blob/main/awesome.md) is a collection of links and resources related to some project or topic. Think of it like a central curated hub to discover interesting stuff.
+
+
### How can I contribute to this repo?
> Perferably, open a [Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) with your changes, or use one of the methods in the next question to contact me.
### I found a mistake, broken link, or something else. What should I do?
-> Open a [new discussion](https://github.com/djsime1/awesome-flipperzero/discussions/new) on this repo, Message me on Discord ([`@DJ#9822`](https://discord.gg/9rduBhctJ6)), Telegram ([`djsime1`](https://t.me/djsime1)), or email me (![djβatβdj.je](https://user-images.githubusercontent.com/8518150/180326401-1408742a-124c-49a7-9818-60c31d0e0d28.png)).
+> Open a [new discussion](https://github.com/djsime1/awesome-flipperzero/discussions/new) on this repo, or contact me via one of the methods listed on [this page](https://dj.je/pages/contact).
### Why are there so many unmerged pull requests?
> If there's multiple small pull requests open at the same time, I'll often merge them together as a single update. Due to the way GitHub works, I'm unable to mark them as merged when I do this. To compensate, I include the contributors as co-authors on the commit, and mention the Pull Request ID's as part of the update message.
@@ -197,6 +201,16 @@
Once you have the CLI open, type log
and press enter to start watching logs. Press Ctrl-C
or Cmd-C
to exit log mode.
+### How can I tell if I'm running the Iceman edition firmware?
+
+ From the idle screen, press right to open your Flipper's passport.
+ Check for the Iceman logo on the left, like in this screenshot:
+
+ (Click to reveal screenshot)
+
+
+
+
## Sub-GHz [π](#top)
@@ -246,24 +260,24 @@
### Feature/Compatability table
-| Card name/type | Read | Write | Save | Emulate | Notes |
-| :--------------- | :--: | :---: | :--: | :-----: | :-------------------- |
-| Mifare Classic | β
| | β
| β
| Emulation is hit/miss |
-| Mifare DESFire | β
| | | | |
-| Mifare Ultralight | β
| | β
| β
| Non-password protected |
-| EMV Cards | β
| | | | Can read bank cards |
-| NTAG-21X | β
| | β
| β
| |
-| NFC-B | | | | β | No hardware support for emulation |
-| iClass/PicoPass | β
| | β
| β | No STM SDK support for emulation |
-| EM4100/EM4102 | β
| β | β
| β
| |
-| H10301 | β
| β | β
| β
| |
-| Indala | β
| β | β
| β
| |
-| T5577 | β
| β
| β
| β
| |
-| EM4305 | β
| β
| β
| β
| |
-| Paxton Net2 | β | β | β | β | Hitag2: no support |
-| Legic Prime | β | β | β | β | 13.56mhz, but proprietary|
+| Card name/type | Read | Write | Save | Emulate | Notes |
+| :---------------- | :--: | :---: | :--: | :-----: | :-------------------------------- |
+| Mifare Classic | β
| β
| β
| β
| Emulation can be a hit or miss |
+| Mifare DESFire | β
| | | | Can read public files |
+| Mifare Ultralight | β
| | β
| β
| Unlock tags with various methods |
+| NTAG-21X | β
| | β
| β
| Very similar to Mifare Ultralight |
+| EMV Cards | β
| | β | β | Can read unencrypted bank cards |
+| NFC-B | | | | β | No hardware support for emulation |
+| iClass/PicoPass | β
| | β
| β | No STM SDK support for emulation |
+| EM4100/EM4102 | β
| β | β
| β
| |
+| H10301 | β
| β | β
| β
| |
+| Indala | β
| β | β
| β
| |
+| T5577 | β
| β
| β
| β
| |
+| EM4305 | β
| | β
| β
| |
+| Paxton Net2 | β | β | β | β | No support for Hitag2 |
+| Legic Prime | β | β | β | β | Proprietary protocol |
-***Note:*** *While T5577 and EM4305's can be written, they are rarely handed out as ID badges.*
+***Key:*** *Check = Already implimented as of latest official firmware. No mark = Could be implemented in the future. Cross mark = Unlikely to ever be implemented or impossible.*
### How do I identify which type of card/tag I have?
> To determine the protocol (NFC, RFID, or iClass/PicoPass) you'll need to attempt reading in each corresponding app. If nothing works, check the tag/card for any markings or indications. As a last resort, take a picture of the card/fob and the reader and ask in the [Flipper Discord server](https://flipperzero.one/discord).
@@ -272,8 +286,9 @@
> Run the "Read card" action in the NFC app. Only NFC-A type tags are supported (Mifare/NTAG/Some EMV).
> Once successfully read, the tag's type is displayed in bold at the top of the screen.
-### Why can't I write an NFC tag?
-> This will become possible in the near future with a firmware update.
+### Which NFC tags can I write?
+> Currently, Mifare Classic's are the only NFC card that can be written to.
+> More will be added in the future with firmware updates.
### I was told a Mifare Ultralight/NTAG tag has password-protected sectors. What does that mean?
> Either the read was interrupted, or the tag is actually password protected.
@@ -318,6 +333,10 @@
### Is there any way to save then emulate a bank card to authorize transactions?
> No, as explained in the previous question.
+### Why does the NFC feature table say bank cards can be read?
+> Most NFC-enabled bank cards expose their card number unencrypted. The expiration date, CVV, and ZIP code are not revealed.
+> The card number alone is not enough to create a transaction, thus there's no reason to add a save option.
+
### Can Flipper emulate a payment terminal and authorize transactions?
> No. Are you starting to see a pattern here?
diff --git a/Firmwares.md b/Firmwares.md
index 03f7bc79..14d6ea15 100644
--- a/Firmwares.md
+++ b/Firmwares.md
@@ -1,106 +1,139 @@
Flipper Zero firmware differences
- ::
Last updated Oct 12 2022. ::
+ ::
Last updated Nov 24 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.
-
-
+ This document maintains a list of differences between various forks of the
+ Flipper Zero firmware.
+
+
+
- - 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) that cannot 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.
-
+ - 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) that cannot 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.
+
-Unleashed
- DarkFlippers/unleashed-firmware
-
+
- - (AKA Code Grabber firmware.)
- - Very active development and Discord community.
- - Removes Sub-GHz regional transmission restrictions by default.
- - Allows Sub-GHz extended frequency range (i.e. restaurant pagers) through dangerous_settings file.
- - Adds extra Sub-GHz frequencies by default through Official setting_user file.
- - Adds extra Mifare classic keys to included dict file and leaves user file untouched.
- - Can be used to capture and send dynamic encrypted protocols/rolling codes. (Modern garage doors, etc.)
- - Encrypted Sub-GHz signals and codes can be added manually.
- - Current modified and new Sub-GHz protocols list can be found here.
- - Comes with extra apps and plugins from the general community through SD Application loader (FAP files).
-
- More details and full list of changes can be found in their README.
+ - (AKA Code Grabber firmware.)
+ - Very active development and Discord community.
+ - Removes Sub-GHz regional transmission restrictions by default.
+ - Allows Sub-GHz extended frequency range (i.e. restaurant pagers) through dangerous_settings file.
+ - Adds extra Sub-GHz frequencies by default through Official setting_user file.
+ - Adds extra Mifare classic keys to included dict file and leaves user file untouched.
+ - Can be used to capture and send dynamic encrypted protocols/rolling codes. (Modern garage doors, etc.)
+
+ - Encrypted Sub-GHz signals and codes can be added manually.
+ - Current modified and new Sub-GHz protocols list can
+ be found here.
+ - Comes with extra apps and plugins from the general community through SD Application loader (FAP files).
+
+ - More details and full list of changes can be found in their README.
+
-RogueMaster
- RogueMaster/flipperzero-firmware-wPlugins
-
+
- - Built off Unleashed as the base firmware (which is a fork of Official dev firmware.)
- - Removes Sub-GHz regional transmission restrictions after changes to extend_range.txt file.
+ - Built off Unleashed as the base firmware (which is a fork of Official dev firmware.)
+ - Removes Sub-GHz regional transmission restrictions after changes to extend_range.txt file.
- Allows Sub-GHz extended frequency range (i.e. restaurant pagers) through extend_range.txt file.
- - Has Sub-GHz protocols and most of the other changes taken from Unleashed FW (see changes).
- - Adds extra custom assets (Mifare classic dict, example files, etc).
- - Includes some PRs from Official firmware that are not yet merged in Official firmware (bleeding edge).
- - Includes experimental "Games Only Mode" (aka Dumb Mode).
- - Includes an enhanced, but experimental, new "Dolphin Level" system.
- - Includes extra apps and plugins from the general community through SD Application loader (FAP files).
- - Also includes a number of other small tweaks, changes, and a ton of additional animations.
- - More details and full list in their README.
+ - Has Sub-GHz protocols and most of the other changes taken from Unleashed FW (see changes).
+ - Adds extra custom assets (Mifare classic dict, example files, etc).
+ - Includes some PRs from Official firmware that are not yet merged in Official firmware (bleeding edge).
+
+ - Includes experimental "Games Only Mode" (aka Dumb Mode).
+ - Includes an enhanced, but experimental, new "Dolphin Level" system.
+ - Includes extra apps and plugins from the general community through SD Application loader (FAP files).
+ - Also includes a number of other small tweaks, changes, and a ton of additional animations.
+
+ - More details and full list in their README.
+
-v1nc
- v1nc/flipperzero-firmware
-
+
- - Supports different keyboard layouts for Duckyscripts via the script keyword
DUCKY_LANG
.
- - Out of date with upstream Unleashed firmware, appears to not be maintained.
- - Includes some integrated community plugins & games but not updated FAP loader.
+ - Supports different keyboard layouts for Duckyscripts via the script keyword
DUCKY_LANG
.
+ - Out of date with upstream Unleashed firmware, appears to not be maintained.
+ - Includes some integrated community plugins & games but not updated FAP loader.
-Wetox
- wetox-team/flipperzero-firmware
-
+
- - 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.
+ - 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.
-MuddledBox
- MuddledBox/flipperzero-firmware
-
+
- - The first 'custom firmware', nowadays abandoned.
- - 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.
+ - The first 'custom firmware', nowadays abandoned.
+ - 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)
+
+ π 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 core functionality, stability, and Sub-GHz protocols.
- - RogueMaster is more focused on visual tweaks, new items, and changes (some experimental).
- - RogueMaster is based on Unleashed, but may be less stable than Unleashed in some circumstances.
-
+
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 core functionality, stability, and Sub-GHz protocols.
+ RogueMaster is more focused on visual tweaks, new items, and changes (some experimental).
+ RogueMaster is based on Unleashed, but may be less stable than Unleashed in some circumstances.
+
\ No newline at end of file
diff --git a/README.md b/README.md
index 78cc1c3b..10119ca5 100644
--- a/README.md
+++ b/README.md
@@ -49,14 +49,9 @@
- [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer)
- [`flipperzero-bruteforce` Generate .sub files to brute force Sub-GHz OOK.](https://github.com/tobiabocchi/flipperzero-bruteforce)
- [`UNC0V3R3D BadUSB collection` Yet another BadUSB collection.](https://github.com/UNC0V3R3D/Flipper_Zero-BadUsb)
+- [`Flipper-StarNew` Universal Intercom Keys.](https://github.com/GlUTEN-BASH/Flipper-Starnew)
## Applications & Plugins
-
-
-
- [`Flipper-Plugin-Tutorial` Updated plugin tutorial based on new build methods.](https://github.com/csBlueChip/FlipperZero_plugin_howto)
- [`Spectrum analyzer` Sub-GHz frequency spectrum analyzer.](https://github.com/jolcese/flipperzero-firmware/tree/spectrum/applications/spectrum_analyzer)
- [`Tetris` A rudimentary Tetris game.](https://github.com/jeffplang/flipperzero-firmware/tree/tetris_game/applications/tetris_game)
@@ -76,6 +71,8 @@
- [`SD Load Applications` Prebuilt applications (FAP) for popular firmware options.](https://github.com/UberGuidoZ/Flipper/tree/main/Applications)
- [`Tuning Fork` Use your flipper as a tuning fork.](https://github.com/besya/flipperzero-tuning-fork)
- [`GPS` Display data from a serial GPS module.](https://github.com/ezod/flipperzero-gps)
+- [`USB HID Autofire` Send left-clicks as a USB HID device.](https://github.com/pbek/usb_hid_autofire)
+- [`Flipper Authenticator` Generate TOTP authentication codes.](https://github.com/akopachov/flipper-zero_authenticator/)
## Firmwares & Tweaks
@@ -86,7 +83,7 @@
- [`Unleashed` Unlocked firmware with rolling codes support & community plugins, stable tweaks, and games.](https://github.com/DarkFlippers/unleashed-firmware)
- [`RogueMaster` Fork of Unleashed firmware with custom graphics, experimental tweaks, community plugins and games.](https://github.com/RogueMaster/flipperzero-firmware-wPlugins)
-- [`v1nc flipper zero firmware` Unleashed fork with support for different Duckyscript keyboard layouts & community plugins](https://github.com/v1nc/flipperzero-firmware)
+- [`v1nc flipper zero firmware` Unleashed fork with support for different Duckyscript keyboard layouts & community plugins.](https://github.com/v1nc/flipperzero-firmware)
- [`Wetox` Very similar to the official branch, with a few small tweaks.](https://github.com/wetox-team/flipperzero-firmware)
- [`Muddled Forks` Less-active firmware modifications.](https://github.com/MuddledBox/flipperzero-firmware/tree/muddled_dev)
- [`OpenHaystack BLE mod` Very old PoC that makes Flipper behave like an AirTag.](https://github.com/AlexStrNik/flipperzero-firmware)
@@ -107,6 +104,7 @@
- [`Flipper Zero Boards` ESP32 and NRF24 daughterboards for the Flipper.](https://github.com/DrB0rk/Flipper-Zero-Boards)
- [`Flipper Zero Car Mount` Uses foam from the original box.](https://www.thingiverse.com/thing:5464899)
- [`Soft TPU cover` Similar to the official silicone case.](https://www.printables.com/en/model/272676-soft-tpu-flipper-zero-cover)
+- [`Flipper-Boy` Flipper Zero Case with 22mm Watch Strap Adapter.](https://www.printables.com/model/304243-flipper-boy)
## Off-device & Debugging
- [`Official Web Interface` Web interface to interact with Flipper, including Paint and SUB/IR analyzer.](https://my.flipp.dev/)
@@ -123,7 +121,7 @@
- [`FlippMibo` Yet another Amiibo to Flipper conversion script.](https://github.com/0xz00n/FlipMiibo)
- [`mfkey32v2` MFC key recovery reader attack.](https://github.com/equipter/mfkey32v2)
- [`Fztea` Connect to your Flipper's UI over serial or make it accessible via SSH.](https://github.com/jon4hz/fztea)
-- [`pyFlipper` Unofficial CLI wrapper writter in Python](https://github.com/wh00hw/pyFlipper)
+- [`pyFlipper` Unofficial CLI wrapper writter in Python.](https://github.com/wh00hw/pyFlipper)
- [`SUB Plotters / comparers` Python package to plot and compare multiple .sub files.](https://github.com/ShotokanZH/flipper_sub_plotters_comparers)
- [`ClassicConverted` Converts Mifare Classic binary files to Flipper.](https://github.com/equipter/ClassicConverter)
- [`musicxml2fmf` Converts MusicXML files to Flipper Music Format.](https://github.com/white-gecko/musicxml2fmf)
@@ -131,6 +129,7 @@
- [`U2F SSH Keys` U2F ECDSA SSH Key Generation using Flipper Zero.](https://gist.github.com/BlackPropaganda/44c40f7855a90e289a9477b654e54eb1)
- [`flipper0` Rusty crate with safe interface to Flipper Firmware and autogen bindings underneath.](https://crates.io/crates/flipper0)
- [`flipperzero-rs` Hand-crafted bindings to Flipper Firmware with custom build tool.](https://github.com/dcoles/flipperzero-rs)
+- [`fzfs` Flipper Zero filesystem driver.](https://github.com/dakhnod/fzfs)
## Notes & References
- [`Official battery self-repair guide` How to troubleshoot battery issues.](https://cdn.flipperzero.one/self-repair-guide.pdf)
@@ -140,7 +139,7 @@
- [`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)
- [`Flipper Zero GPIO Pinout` Official GPIO pinouts.](https://miro.com/app/board/uXjVO_LaYYI=/?moveToWidget=3458764522696947614&cot=10)
-- [`Add-on Modules GPIO Pinouts` ESP32, ESP8266, ESP32-CAM, ESP32-WROOM, NRF24](https://github.com/UberGuidoZ/Flipper/tree/main/GPIO)
+- [`Add-on Modules GPIO Pinouts` ESP32, ESP8266, ESP32-CAM, ESP32-WROOM, NRF24.](https://github.com/UberGuidoZ/Flipper/tree/main/GPIO)
- [`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)