From ab0b7bb1df9889a3ee333fac5c7febe613354830 Mon Sep 17 00:00:00 2001 From: David Date: Mon, 1 Aug 2022 23:59:12 -0500 Subject: [PATCH 01/35] Update 39 --- FAQ.md | 55 +++++++++++++++++++++++++++++++++++++++++++------------ README.md | 1 + 2 files changed, 44 insertions(+), 12 deletions(-) diff --git a/FAQ.md b/FAQ.md index 8cf8e695..47784d4e 100644 --- a/FAQ.md +++ b/FAQ.md @@ -9,7 +9,7 @@ General Sub-GHz NFC & RFID - Infrared + Infrared iButton BadUSB WiFi board @@ -38,35 +38,35 @@ Open a [new discussion](https://github.com/djsime1/awesome-flipperzero/discussio ## General -### What MicroSD card should I use? +### What MicroSD Card should I use? - It should be a reputable brand (Like SanDisk, Sony, etc.) because often cheaper cards don't fully support the communication protocol Flipper uses. - The card should have a capacity between 4 and 64 GB, but an 8 GB card is MORE than enough. - After inserting the card, use the Flipper's setting menu to format (clear) and test the card. - Before ejecting the card, unmount it via the Settings menu to ensure data isn't corrupted. -- Note: You might need a paperclip or similar object to push the SD card in and out of the device. +- Note: You might need a paperclip or similar object to push the SD Card in and out of the device. - Read the [official documentation](https://docs.flipperzero.one/basics/sd-card) for more information! ### How do I install databases and dumps? -Make sure there's a working MicroSD card in the device first by following the steps above. -Once you download the dump, you can use qFlipper or the Flipper mobile app to transfer them. If you're transfering a large file or many at once, you can also eject the SD card from Flipper and insert it in your computer for faster transfers. -- In qFlipper: Plug your device in, go to the file browser tab, navigate into the SD card, and drop files in their corresponding folders (The folder names are similar to the file extensions). +Make sure there's a working MicroSD Card in the device first by following the steps above. +Once you download the dump, you can use qFlipper or the Flipper mobile app to transfer them. If you're transfering a large file or many at once, you can also eject the SD Card from Flipper and insert it in your computer for faster transfers. +- In qFlipper: Plug your device in, go to the file browser tab, navigate into the SD Card, and drop files in their corresponding folders (The folder names are similar to the file extensions). - For mobile apps: Make sure you're connected via Bluetooth, save the file to the app's archive, and synchronize it back to the device. -- For plugging the SD card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). +- For plugging the SD Card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). ### How do I install applications and plugins? The links listed in this repo can't be installed as easily as drag-and-drop. Most of them have to be manually merged into the firmware and fully recompiled. (Documentation coming soon) As for ELF/FAP's, they're in a very early stage of development and require a special version of the firmware to be installed. I DO NOT recommend using them until they are officially merged into the main firmware. -*If you're really insistent, install the firmware from [this comment](https://github.com/flipperdevices/flipperzero-firmware/pull/1387#issuecomment-1182470778), place the `.elf` or `.fap` file in the `apps` directory on the SD card (create it if necessary), and use the ELF loader application to run them.* +*If you're really insistent, install the firmware from [this comment](https://github.com/flipperdevices/flipperzero-firmware/pull/1387#issuecomment-1182470778), place the `.elf` or `.fap` file in the `apps` directory on the SD Card (create it if necessary), and use the ELF loader application to run them.* ### How do I write my own applications/plugins/firmware? (WIP) ### How do I install custom firmwares? First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? -After you've ignored the previous sentences, make sure there's a working MicroSD card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, always contains a file named `update.fuf`). +After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, always contains a file named `update.fuf`). - If you only have a `.dfu`, it can be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. -- If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD card (create if needed). Once transferred, go to the idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. +- If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create if needed). Once transferred, go to the idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). @@ -86,6 +86,21 @@ These are all hardware mods, inaccessible to the average user. Look up/ask aroun ### Will there be future hardware revisions? [Not for the Flipper Zero.](https://discord.com/channels/740930220399525928/746304505879986267/1001167062728720395) While there are concepts for a [Flipper One](https://flipperzero.one/one), there is not any timeline for release. +### What is DUMB mode? +It's a yet to be implimented mode that would hide all of the potentially malicious apps/features of Flipper. + +### My device is frozen, how do I reboot/fix it? +- To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. +- To enter DFU/Recovery mode: Hold BACK and LEFT, then release BACK while still holding LEFT after a few seconds. When the screen lights up, you can release LEFT. +- To exit DFU/Recovery mode: Follow steps for a normal reboot under the first bullet point. + +If nothing works or the device is completely bricked, first make sure it's charged by plugging it in for 15-30 minutes. As a final resort, if you can't get it to turn on after charging, *unplug the USB cable* and hold OK plus BACK for 30 seconds. **There will be no indication**, but the device is now in recovery mode. Plug it in to a PC and use qFlipper to recover the firmware. +Read the official docs for [Control](https://docs.flipperzero.one/basics/control), [Reboot](https://docs.flipperzero.one/basics/reboot), and [Firmware recovery](https://docs.flipperzero.one/basics/firmware-update/firmware-recovery). + +### How do I access the CLI/Logs? +(WIP) + + ## Sub-GHz @@ -167,7 +182,7 @@ The read has failed, meaning the card didn't use any common keys. If you have ac ### What does it mean when some but not all sectors could be read on a Mifare Classic? The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. The read wasn't successful, but it didn't fail either. Some of the card's data was read and saved, but not all. -Even if not all sectors were read, it's still worth trying to use the partial save. +Even if not all sectors were read, there's a slim chance a partial save will work with emulation. ### Why isn't Mifare Classic emulation working? There are a number of reasons, some of which can be fixed while others can't. The first thing you should check is that all sectors were read from the card. If not, look at the questions above. @@ -177,10 +192,26 @@ On the software side: Some rarely used card commands (counters, restore, and tra ### Why can't I save/emulate Mifare DESFire? DESFire is a very complicated and much more secure chipset. There are no known attacks against it yet. -### What are the .sha files in the NFC directory? +### What are the .shd files in the NFC directory? These are shadow files, and they're created whenever an emulated tag is written to. They store a copy of the original file with whatever was written. This way, the original file remains untouched. +### How do I edit the data in a saved tag? +You'll need to use a NFC-enabled smartphone with an app that can write tags. One of the easiest to use apps is called NFC Tools, available for both [Android](https://play.google.com/store/apps/details?id=com.wakdev.wdnfc) and [iOS](https://apps.apple.com/us/app/nfc-tools/id1252962749). Due to Mifare Classic emulation quirks, you can only edit the data of saved NTAG and Mifare Ultralight tags. Create an empty NTAG216 with the "Add Manually" action in the NFC app if you don't have one already. Save that tag, then open it from the list. Once you start emulating the tag, you can use the NFC Tools smartphone app to write information on to the emulated tag. This is saved to a .shd file with the same name as the emulated tag. If you need a quick way to generate a tag containing a URL, you can use [Flipper Maker's NFC Creator tool](https://flippermaker.github.io/) online. + ### Why doesn't my bank card work when I emulate it? EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. + + +## Infrared + +### How do I add more devices to the "Universal Remotes" menu? +While it isn't possible to add new items under the universal menu, there exist plenty of repositories containing many dumps of IR remotes. The most popular is [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). +(Note: When downloading, it's *highly recommended* to unmount the SD Card from your Flipper and directly plug it in to your computer.) + +### The universal TV remote doesn't work besides the power button. +The stock universal tv remote database mostly contains power codes, and very few of everything else. This file (Located at `infrared/assets/tv.ir` on the SD Card) be manually replaced with one containing extra codes for all buttons. To do so, download [this file](https://raw.githubusercontent.com/UberGuidoZ/Flipper/main/Infrared/tv.ir) and use qFlipper to transfer it into the path from the previous sentence. + +### What are CSV/Pronto/IR Plus codes? +All three are different formats of infrared databases. They are not natively compatible with Flipper, but repositories exist that hold converted and compatible versions, such as [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). \ No newline at end of file diff --git a/README.md b/README.md index 89d44678..08422dc7 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,7 @@ - [`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) - [`irplus database` Ripped from irplus App.](https://github.com/sasiplavnik/Flipper-IRDB) +- [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer) ## Applications & Plugins From e98fd015b46f9e468850cd44adc7d9c24abbe7df Mon Sep 17 00:00:00 2001 From: David Date: Tue, 2 Aug 2022 00:09:01 -0500 Subject: [PATCH 02/35] Update 40 (Closes #35, Closes #36) Co-authored-by: wh00hw <00wh00@protonmail.com> Co-authored-by: TQMatvey <77576395+TQMatvey@users.noreply.github.com> --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 08422dc7..cabba09e 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ ✨ This section will be succeeded by
Aquarium once SD-Card apps are released. -- [`Flipper-Plugin-Tutorial` Building a Custom "Hello world" plugin.](https://github.com/DroomOne/Flipper-Plugin-Tutorial) +- [`Flipper-Plugin-Tutorial` Building a Custom "Hello world" plugin.](https://github.com/mfulz/Flipper-Plugin-Tutorial) - [`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) - [`Flappy Bird` The name says it all.](https://github.com/DroomOne/flipperzero-firmware/tree/dev/applications%2Fflappy_bird) @@ -95,6 +95,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) ## Notes & References From 9aca43e9d275aa9fce84238ae21cf1a6bfe6fee7 Mon Sep 17 00:00:00 2001 From: David Date: Tue, 2 Aug 2022 03:08:03 -0500 Subject: [PATCH 03/35] Update 41 --- FAQ.md | 263 +++++++++++++++++++++++++++++++++++------------------- README.md | 24 +++-- 2 files changed, 187 insertions(+), 100 deletions(-) diff --git a/FAQ.md b/FAQ.md index 47784d4e..504e44b3 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,147 +1,217 @@ - + Flipper Zero FAQ
- - - - - + + + + + + -
Table of Contents
MetaGeneralSub-GHzNFC & RFIDInfraredMetaGeneralSub-GHzNFC & RFIDInfraredBadUSB iButtonBadUSB WiFi board
-## Preamble +## Preamble [πŸ”](#top) - *This is a community FAQ. Please consider also reading the [Official docs](https://docs.flipperzero.one/).* - *This FAQ is still being worked on, and contributions are welcome.* - *If your question isn't answered here, **SEARCH** the [Discord](https://flipperzero.one/discord) and check pinned messages before asking there.* -## Meta +## Meta [πŸ”](#top) ### 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. +> 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. ### 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. +> 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, 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)). + +### 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. -## General +## General [πŸ”](#top) ### What MicroSD Card should I use? -- It should be a reputable brand (Like SanDisk, Sony, etc.) because often cheaper cards don't fully support the communication protocol Flipper uses. -- The card should have a capacity between 4 and 64 GB, but an 8 GB card is MORE than enough. -- After inserting the card, use the Flipper's setting menu to format (clear) and test the card. -- Before ejecting the card, unmount it via the Settings menu to ensure data isn't corrupted. -- Note: You might need a paperclip or similar object to push the SD Card in and out of the device. -- Read the [official documentation](https://docs.flipperzero.one/basics/sd-card) for more information! +> - It should be a reputable brand (Like SanDisk, Sony, etc.) because often cheaper cards don't fully support the communication protocol Flipper uses. +> - The card should have a capacity between 4 and 64 GB, but an 8 GB card is MORE than enough. +> - After inserting the card, use the Flipper's setting menu to format (clear) and test the card. +> - Before ejecting the card, unmount it via the Settings menu to ensure data isn't corrupted. +> - Note: You might need a paperclip or similar object to push the SD Card in and out of the device. +> - Read the [official documentation](https://docs.flipperzero.one/basics/sd-card) for more information! ### How do I install databases and dumps? -Make sure there's a working MicroSD Card in the device first by following the steps above. -Once you download the dump, you can use qFlipper or the Flipper mobile app to transfer them. If you're transfering a large file or many at once, you can also eject the SD Card from Flipper and insert it in your computer for faster transfers. -- In qFlipper: Plug your device in, go to the file browser tab, navigate into the SD Card, and drop files in their corresponding folders (The folder names are similar to the file extensions). -- For mobile apps: Make sure you're connected via Bluetooth, save the file to the app's archive, and synchronize it back to the device. -- For plugging the SD Card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). +> Make sure there's a working MicroSD Card in the device first by following the steps above. +> Once you download the dump, you can use qFlipper or the Flipper mobile app to transfer them. If you're transfering a large file or many at once, you can also eject the SD Card from Flipper and insert it in your computer for faster transfers. +> - In qFlipper: Plug your device in, go to the file browser tab, navigate into the SD Card, and drop files in their corresponding folders (The folder names are similar to the file extensions). +> - For mobile apps: Make sure you're connected via Bluetooth, save the file to the app's archive, and synchronize it back to the device. +> - For plugging the SD Card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). ### How do I install applications and plugins? -The links listed in this repo can't be installed as easily as drag-and-drop. -Most of them have to be manually merged into the firmware and fully recompiled. (Documentation coming soon) -As for ELF/FAP's, they're in a very early stage of development and require a special version of the firmware to be installed. I DO NOT recommend using them until they are officially merged into the main firmware. -*If you're really insistent, install the firmware from [this comment](https://github.com/flipperdevices/flipperzero-firmware/pull/1387#issuecomment-1182470778), place the `.elf` or `.fap` file in the `apps` directory on the SD Card (create it if necessary), and use the ELF loader application to run them.* +> The links listed in this repo can't be installed as easily as drag-and-drop. +> Most of them have to be manually merged into the firmware and fully recompiled. (Documentation coming soon) +> As for ELF/FAP's, they're in a very early stage of development and require a special version of the firmware to be installed. I DO NOT recommend using them until they are officially merged into the main firmware. +> *If you're really insistent, install the firmware from [this comment](https://github.com/flipperdevices/flipperzero-firmware/pull/1387#issuecomment-1182470778), place the `.elf` or `.fap` file in the `apps` directory on the SD Card (create it if necessary), and use the ELF loader application to run them.* ### How do I write my own applications/plugins/firmware? -(WIP) +> *(WIP)* ### How do I install custom firmwares? -First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? -After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, always contains a file named `update.fuf`). -- If you only have a `.dfu`, it can be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. -- If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create if needed). Once transferred, go to the idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. - -If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. -For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). +> First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? +> After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, always contains a file named `update.fuf`). +> - If you only have a `.dfu`, it can be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. +> - If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create if needed). Once transferred, go to the idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. +> +> If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. +> For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). ### How do I compile my own firmware/applications/assets? -(WIP) +> *(WIP)* ### Can I make my own Flipper instead of buying one? -Probably not. While the firwmare and schematics are mostly public, actually sourcing the components is extremely difficult. Multiple core pieces, such as the screen, were specficially produced to be used in Flipper manufacturing. +> Probably not. While the firwmare and schematics are mostly public, actually sourcing the components is extremely difficult. Multiple core pieces, such as the screen, were specficially produced to be used in Flipper manufacturing. ### How do I get a black-case Flipper? -This is no longer possible, they were Kickstarter-backer exclusives. +> This is no longer possible, they were Kickstarter-backer exclusives. ### How do I invert the screen/change backlight color/change case cover, etc. -These are all hardware mods, inaccessible to the average user. Look up/ask around on how to do them. +> These are all hardware mods, inaccessible to the average user. Look up/ask around on how to do them. ### Will there be future hardware revisions? -[Not for the Flipper Zero.](https://discord.com/channels/740930220399525928/746304505879986267/1001167062728720395) While there are concepts for a [Flipper One](https://flipperzero.one/one), there is not any timeline for release. +> [Not for the Flipper Zero.](https://discord.com/channels/740930220399525928/746304505879986267/1001167062728720395) While there are concepts for a [Flipper One](https://flipperzero.one/one), there is not any timeline for release. ### What is DUMB mode? -It's a yet to be implimented mode that would hide all of the potentially malicious apps/features of Flipper. +> It's a yet to be implimented mode that would hide all of the potentially malicious apps/features of Flipper. ### My device is frozen, how do I reboot/fix it? -- To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. -- To enter DFU/Recovery mode: Hold BACK and LEFT, then release BACK while still holding LEFT after a few seconds. When the screen lights up, you can release LEFT. -- To exit DFU/Recovery mode: Follow steps for a normal reboot under the first bullet point. - -If nothing works or the device is completely bricked, first make sure it's charged by plugging it in for 15-30 minutes. As a final resort, if you can't get it to turn on after charging, *unplug the USB cable* and hold OK plus BACK for 30 seconds. **There will be no indication**, but the device is now in recovery mode. Plug it in to a PC and use qFlipper to recover the firmware. -Read the official docs for [Control](https://docs.flipperzero.one/basics/control), [Reboot](https://docs.flipperzero.one/basics/reboot), and [Firmware recovery](https://docs.flipperzero.one/basics/firmware-update/firmware-recovery). +> - To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. +> - To enter DFU/Recovery mode: Hold BACK and LEFT, then release BACK while still holding LEFT after a few seconds. When the screen lights up, you can release LEFT. +> - To exit DFU/Recovery mode: Follow steps for a normal reboot under the first bullet point. +> +> If nothing works or the device is completely bricked, first make sure it's charged by plugging it in for 15-30 minutes. As a final resort, if you can't get it to turn on after charging, *unplug the USB cable* and hold OK plus BACK for 30 seconds. **There will be no indication**, but the device is now in recovery mode. Plug it in to a PC and use qFlipper to recover the firmware. +> Read the official docs for [Control](https://docs.flipperzero.one/basics/control), [Reboot](https://docs.flipperzero.one/basics/reboot), and [Firmware recovery](https://docs.flipperzero.one/basics/firmware-update/firmware-recovery). ### How do I access the CLI/Logs? -(WIP) +
+ To access the Serial CLI, click one of the following based on your platform. +
+ Desktop web browser* + *Chromium browsers only, such as: Google Chrome, Microsoft Edge, Opera/Opera GX, Brave, and Vivaldi. +
    +
  • Connect your Flipper via USB.
    • +
  • Ensure qFlipper and any other serial terminals are closed.
    • +
  • Open my.flipp.dev in one of the aforementioned browsers.
    • +
  • Click CONNECT and select "USB Serial Device" from the list.
    • +
  • Wait until you can see your device details on screen.
    • +
  • Select the πŸ’» CLI item from the left sidebar.
    • +
  • Done!
    • +
+
+
+ Windows +
    +
  • Install PuTTY if it isn't already.
    • +
  • Connect your Flipper via USB.
    • +
  • Open qFlipper and look for the COM port next to the Flipper's name. (Should say COM followed by a number, like COM1)
    • +
  • Take note of the COM port number.
    • +
  • CLOSE qFlipper, otherwise the next steps won't work.
    • +
  • Open PuTTY and ensure you're on the Session screen.
    • +
  • Select "Serial" under connection type.
    • +
  • Set serial line to the COM port. (Just COM followed by the number, like COM1)
    • +
  • Set speed to 115200
    • +
  • Optional: Save the session settings for easy connection later.
    • +
  • Finally, click Open to enter the CLI.
    • +
  • Done!
    • +
  • If you get an "Access Denied" error, make sure qFlipper isn't running!
    • +
+
+
+ MacOS/Linux + Note: I'm a filthy Windows user without any way to verify this procedure. Let me know if it's wrong! +
    +
  • Install GNU Screen if it isn't already.
    • +
  • Connect your Flipper via USB.
    • +
  • Open qFlipper and look for the device path next to the Flipper's name. (Starts with /dev/tty)
    • +
  • Alternatively: Run ls /dev/tty.* in a terminal.
    • +
  • Take note of the full device path.
    • +
  • CLOSE qFlipper, otherwise the next steps won't work.
    • +
  • Open a terminal.
    • +
  • Run screen PATH 115200, replacing PATH with the device path from earlier.
    • +
  • Done!
    • +
+
+
+ Android +
    +
  • Install Serial USB Terminal if it isn't already.
    • +
  • Open the app and go to the Connections screen in the hamburger menu (3 bars icon)
    • +
  • Connect your Flipper via USB.
    • +
  • Click the refresh icon if it doesn't automatically show up.
    • +
  • Allow Serial USB Terminal to access Flipper if prompted.
    • +
  • If it doesn't automatically connect, click the connect icon in the upper right. (2 plugs icon)
    • +
  • Done!
    • +
  • Note: To exit log mode, you'll have to disconnect and reconnect using the icon.
    • +
+
+
+ iPhone + Unfortunately, iOS is incapable of accessing a serial terminal over USB; try one of the other methods. +
+ On the Flipper, open the settings, go to System, and set Log Level to Debug. (You can keep Debug set to off unless someone asks you to turn it on) + 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. +
-## Sub-GHz +## Sub-GHz [πŸ”](#top) ### How do I hack my neighbors garage or unlock some random persons car?!? -Short answer: You don't. That's illegal, and NOT what Flipper was designed for. +> Short answer: You don't. That's illegal, and NOT what Flipper was designed for. ### What does "This frequency can only be used for RX in your region" mean? -Due to legal regulations, Flipper is not allowed to transmit on certain frequencies depending on your order location. -For more information, referr to the [official documentation](https://docs.flipperzero.one/sub-ghz/frequencies) -If you have no regard for laws, you can use custom firmwares such as Unleashed to bypass this restriction **at your own risk.** +> Due to legal regulations, Flipper is not allowed to transmit on certain frequencies depending on your order location. +> For more information, referr to the [official documentation](https://docs.flipperzero.one/sub-ghz/frequencies) +> If you have no regard for laws, you can use custom firmwares such as Unleashed to bypass this restriction **at your own risk.** ### How do I find the frequency of a device/transponder? -If it's a commonly used frequency, bring the device *really close* to the Flipper and use the Frequency analyzer. -If that didn't work, check for the device's FCC ID. It's legally required to be somewhere on the device if it's sold in the US. -Then, look up that ID on [FCC ID.io](https://fccid.io). +> If it's a commonly used frequency, bring the device *really close* to the Flipper and use the Frequency analyzer. +> If that didn't work, check for the device's FCC ID. It's legally required to be somewhere on the device if it's sold in the US. +> Then, look up that ID on [FCC ID.io](https://fccid.io). ### I can't tune Flipper to capture a specific frequency. -(TODO) +> *(WIP)* ### I captured a garage/car/etc. signal, but it doesn't work when I replay it. -Unless the item of interest is extremely old, it probably uses rolling codes. Read more below. +> Unless the item of interest is extremely old, it probably uses rolling codes. Read more below. ### What is a rolling code? -Think of it like this: Imagine your garage door was programmed to open whenever it received the code "1234" from a transponder. -This would be a static code, where a replay attack (Read RAW) would be able to open the garage. -Since replay attacks are so easy, most devices will shuffle the code after each use. -So the first time you open your garage, the transponder sends "1234" and the second time it sends "5678." -Rolling codes aren't that simple, but you get the gist. +> Think of it like this: Imagine your garage door was programmed to open whenever it received the code "1234" from a transponder. +> This would be a static code, where a replay attack (Read RAW) would be able to open the garage. +> Since replay attacks are so easy, most devices will shuffle the code after each use. +> So the first time you open your garage, the transponder sends "1234" and the second time it sends "5678." +> Rolling codes aren't that simple, but you get the gist. ### I replayed a rolling code and now my original keyfob/transponder doesn't work. -You'll have to re-sync your old device manually, since it's now lagging behind on the rolling code. +> You'll have to re-sync your old device manually, since it's now lagging behind on the rolling code. ### What is a Debruin/Brute force code? -A brute force code tries every possible code for a specific bit length, however this is inefficient. -Example: 0001, 0002, 0003, 0004 ... 9998, 9999. -Debruin sequences are more efficient by merging multiple codes together. -Example: 365, 136, and 650 can all be found in 13650 by looking at groups of 3 digits individually. +> A brute force code tries every possible code for a specific bit length, however this is inefficient. +> Example: 0001, 0002, 0003, 0004 ... 9998, 9999. +> Debruin sequences are more efficient by merging multiple codes together. +> Example: 365, 136, and 650 can all be found in 13650 by looking at groups of 3 digits individually. -## NFC & RFID +## NFC & RFID [πŸ”](#top) ### Feature/Compatability table @@ -160,58 +230,63 @@ Example: 365, 136, and 650 can all be found in 13650 by looking at groups of 3 d | Paxton Net2 | | | | | Hitag2: no support | ### 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). +> 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). ### How do I identify which type of NFC tag I have? -Run the "Read card" action in the NFC app. If you don't see "NFC-A", your card is unfortunately unsupported. -Note that you've only read the card UID and type, *not the actual data.* For that you need to select the "Run compatible app" option. +> Run the "Read card" action in the NFC app. If you don't see "NFC-A", your card is unfortunately unsupported. +> Note that you've only read the card UID and type, *not the actual data.* For that you need to select the "Run compatible app" option. ### Why can't I write an NFC tag? -Currently unsupported, but is being worked on. +> Currently unsupported, but is being worked on. ### Mifare Ultralight/NTAG was detected, but nothing happens when I'm trying to read the data. -This happens when the tag is password protected. There's no quick fix for this, but solutions are in the works. +> This happens when the tag is password protected. There's no quick fix for this, but solutions are in the works. ### Why does it take so long to read a Mifare Classic? -Mifare classics are split up into sectors, these sectors are protected by two keys. To read a Mifare Classic, Flipper uses a dictionary attack, which takes a big list currently comprised of about 2000 common keys, and checks them individually against each sector on the card. If you know the keys, they can be manually added to the User Dictionary under the "Extra Actions" menu. +> Mifare classics are split up into sectors, these sectors are protected by two keys. To read a Mifare Classic, Flipper uses a dictionary attack, which takes a big list currently comprised of about 2000 common keys, and checks them individually against each sector on the card. If you know the keys, they can be manually added to the User Dictionary under the "Extra Actions" menu. ### What does it mean when no sectors could be read on a Mifare Classic? -The data on Mifare Classic cards is split up into sectors, and each section is protected by two keys. -The read has failed, meaning the card didn't use any common keys. If you have access to the card reader, [mfkey32v2](https://github.com/equipter/mfkey32v2) can be used to pull keys from it. +> The data on Mifare Classic cards is split up into sectors, and each section is protected by two keys. +> The read has failed, meaning the card didn't use any common keys. If you have access to the card reader, [mfkey32v2](https://github.com/equipter/mfkey32v2) can be used to pull keys from it. ### What does it mean when some but not all sectors could be read on a Mifare Classic? -The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. -The read wasn't successful, but it didn't fail either. Some of the card's data was read and saved, but not all. -Even if not all sectors were read, there's a slim chance a partial save will work with emulation. +> The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. +> The read wasn't successful, but it didn't fail either. Some of the card's data was read and saved, but not all. +> Even if not all sectors were read, there's a slim chance a partial save will work with emulation. ### Why isn't Mifare Classic emulation working? -There are a number of reasons, some of which can be fixed while others can't. The first thing you should check is that all sectors were read from the card. If not, look at the questions above. -On the hardware side: Mifare Classic emulation is handled by the CPU, except the clock cycle can't conform to the exact (and strict) timings that these tags communicate with. -On the software side: Some rarely used card commands (counters, restore, and transfer) haven't been implimented, thus they will always fail during emulation. +> There are a number of reasons, some of which can be fixed while others can't. The first thing you should check is that all sectors were read from the card. If not, look at the questions above. +> On the hardware side: Mifare Classic emulation is handled by the CPU, except the clock cycle can't conform to the exact (and strict) timings that these tags communicate with. +> On the software side: Some rarely used card commands (counters, restore, and transfer) haven't been implimented, thus they will always fail during emulation. ### Why can't I save/emulate Mifare DESFire? -DESFire is a very complicated and much more secure chipset. There are no known attacks against it yet. +> DESFire is a very complicated and much more secure chipset. There are no known attacks against it yet. ### What are the .shd files in the NFC directory? -These are shadow files, and they're created whenever an emulated tag is written to. -They store a copy of the original file with whatever was written. This way, the original file remains untouched. +> These are shadow files, and they're created whenever an emulated tag is written to. +> They store a copy of the original file with whatever was written. This way, the original file remains untouched. ### How do I edit the data in a saved tag? -You'll need to use a NFC-enabled smartphone with an app that can write tags. One of the easiest to use apps is called NFC Tools, available for both [Android](https://play.google.com/store/apps/details?id=com.wakdev.wdnfc) and [iOS](https://apps.apple.com/us/app/nfc-tools/id1252962749). Due to Mifare Classic emulation quirks, you can only edit the data of saved NTAG and Mifare Ultralight tags. Create an empty NTAG216 with the "Add Manually" action in the NFC app if you don't have one already. Save that tag, then open it from the list. Once you start emulating the tag, you can use the NFC Tools smartphone app to write information on to the emulated tag. This is saved to a .shd file with the same name as the emulated tag. If you need a quick way to generate a tag containing a URL, you can use [Flipper Maker's NFC Creator tool](https://flippermaker.github.io/) online. +> You'll need to use a NFC-enabled smartphone with an app that can write tags. One of the easiest to use apps is called NFC Tools, available for both [Android](https://play.google.com/store/apps/details?id=com.wakdev.wdnfc) and [iOS](https://apps.apple.com/us/app/nfc-tools/id1252962749). Due to Mifare Classic emulation quirks, you can only edit the data of saved NTAG and Mifare Ultralight tags. Create an empty NTAG216 with the "Add Manually" action in the NFC app if you don't have one already. Save that tag, then open it from the list. Once you start emulating the tag, you can use the NFC Tools smartphone app to write information on to the emulated tag. This is saved to a .shd file with the same name as the emulated tag. If you need a quick way to generate a tag containing a URL, you can use [Flipper Maker's NFC Creator tool](https://flippermaker.github.io/) online. ### Why doesn't my bank card work when I emulate it? -EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. +> EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. -## Infrared +## Infrared [πŸ”](#top) ### How do I add more devices to the "Universal Remotes" menu? -While it isn't possible to add new items under the universal menu, there exist plenty of repositories containing many dumps of IR remotes. The most popular is [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). -(Note: When downloading, it's *highly recommended* to unmount the SD Card from your Flipper and directly plug it in to your computer.) +> While it isn't possible to add new items under the universal menu, there exist plenty of repositories containing many dumps of IR remotes. The most popular is [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). +> (Note: When downloading, it's *highly recommended* to unmount the SD Card from your Flipper and directly plug it in to your computer.) If you only need a remote for one device, you can use [Flipper Maker's IR Device tool](https://flippermaker.github.io/) to create and transfer it on the go. ### The universal TV remote doesn't work besides the power button. -The stock universal tv remote database mostly contains power codes, and very few of everything else. This file (Located at `infrared/assets/tv.ir` on the SD Card) be manually replaced with one containing extra codes for all buttons. To do so, download [this file](https://raw.githubusercontent.com/UberGuidoZ/Flipper/main/Infrared/tv.ir) and use qFlipper to transfer it into the path from the previous sentence. +> The stock universal tv remote database mostly contains power codes, and very few of everything else. This file (Located at `infrared/assets/tv.ir` on the SD Card) be manually replaced with one containing extra codes for all buttons. To do so, download [this file](https://raw.githubusercontent.com/UberGuidoZ/Flipper/main/Infrared/tv.ir) and use qFlipper to transfer it into the path from the previous sentence. ### What are CSV/Pronto/IR Plus codes? -All three are different formats of infrared databases. They are not natively compatible with Flipper, but repositories exist that hold converted and compatible versions, such as [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). \ No newline at end of file +> All three are different formats of infrared databases. They are not natively compatible with Flipper, but repositories exist that hold converted and compatible versions, such as [Flipper-IRDB](https://github.com/logickworkshop/Flipper-IRDB). + + + +## BadUSB [πŸ”](#top) +> *(WIP)* \ No newline at end of file diff --git a/README.md b/README.md index cabba09e..be72ccb8 100644 --- a/README.md +++ b/README.md @@ -16,12 +16,20 @@ -
-

- πŸ‘‹ New to Flipper Zero? Got questions?
- Check out the FAQ Document❗ -

-
+ + + +
+

+ πŸ‘‹ New to Flipper Zero? Got questions?
+ Check out the FAQ Document❗ +

+ 		+

+ 🚫 Not affiliated with
+ Flipper Devices Inc. +

+
@@ -127,4 +135,8 @@ You can Edit this file and open a Pull Request, or Start a discussion with your ideas.
(A GitHub account is required for both) +
+ Why so many umerged 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. +
From 6c2a024b9fb337e79f5edb7f22b6cbfee3dbb788 Mon Sep 17 00:00:00 2001 From: Eric Betts Date: Tue, 2 Aug 2022 11:15:07 -0700 Subject: [PATCH 04/35] Update 42 Update FAQ.md (#37) --- FAQ.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/FAQ.md b/FAQ.md index 504e44b3..6fd11793 100644 --- a/FAQ.md +++ b/FAQ.md @@ -216,18 +216,19 @@ ### Feature/Compatability table | Card name/type | Read | Write | Save | Emulate | Notes | -| :---------------: | :--: | :---: | :--: | :-----: | :--------------------: | -| Mifare Classic | X | | X | X | Emulation is hit/miss | -| Mifare DESFire | X | | | | | -| Mifare Ultralight | X | | X | X | Non-password protected | -| EMV Cards | X | | | | Can read bank cards | -| NTAG-21X | X | | X | X | | -| iClass/PicoPass | X | | X | | | -| EM4100/EM4102 | X | | X | X | | -| H10301 | X | | X | X | | -| Indala | X | | X | X | | -| T5577 | X | X | X | X | | -| Paxton Net2 | | | | | Hitag2: no support | +| :--------------- | :--: | :---: | :--: | :-----: | :-------------------- | +| 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 | βœ… | βœ… | βœ… | βœ… | | +| Paxton Net2 | ❌ | ❌ | ❌ | ❌ | Hitag2: no support | ### 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). @@ -289,4 +290,4 @@ ## BadUSB [πŸ”](#top) -> *(WIP)* \ No newline at end of file +> *(WIP)* From ee0d031d9e41ced930fdd29590e33bda39c04f85 Mon Sep 17 00:00:00 2001 From: UberGuidoZ <57457139+UberGuidoZ@users.noreply.github.com> Date: Tue, 2 Aug 2022 23:06:29 -0700 Subject: [PATCH 05/35] Update 43 Added GPIO docs, reworked firmware and Playground descriptions (#38) * Added GPIO documentation and reworded Playground * Updated Unleashed and RogueMaster descriptions Also reordered them since RogueMaster is based on Unleashed * Added more plugins, reordered Firmwares --- README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index be72ccb8..98c9d8ec 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ ## Databases & Dumps -- [`UberGuidoZ Playground` Large collection of dumps.](https://github.com/UberGuidoZ/Flipper) +- [`UberGuidoZ Playground` Large collection of files, documentation, and dumps of all kinds.](https://github.com/UberGuidoZ/Flipper) - [`Flipper-IRDB` Many IR dumps for various appliances.](https://github.com/logickworkshop/Flipper-IRDB) - [`FlipperZero-TouchTunes` Dumps of TouchTune's remote.](https://github.com/jimilinuxguy/flipperzero-touchtunes) - [`Flipper Maker` Generate Flipper Zero files on the fly.](https://flippermaker.github.io/) @@ -62,6 +62,8 @@ - [`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) +- [`UPC-A Barcode Generator` Can be used to create any UPC-A barcode.](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator) +- [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) ## Firmwares & Tweaks @@ -70,12 +72,12 @@ πŸ”° 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) +- [`Unleashed` Frequency-unlocked firmware with rolling codes support & community plugins.](https://github.com/Eng1n33r/flipperzero-firmware) +- [`RogueMaster` Unleashed + Official FW fork with assorted community plugins, tweaks, & 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) +- [`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) ## Modules & Cases - [`FlipperZero-Hardware` 3D-Printable cases with custom iButton interface.](https://github.com/s0ko1ex/FlipperZero-Hardware) @@ -118,6 +120,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) - [`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) From 0e5a3c056c7f2fa1fc96e617ba24317e5ba33248 Mon Sep 17 00:00:00 2001 From: UberGuidoZ <57457139+UberGuidoZ@users.noreply.github.com> Date: Thu, 4 Aug 2022 12:03:15 -0700 Subject: [PATCH 06/35] Update 44 Large rework of firmware differences/organization (#39) * Reordered menu/FWs to match, fixed typo * Large rework and update of firmware descriptions --- Firmwares.md | 71 +++++++++++++++++++++++++++------------------------- 1 file changed, 37 insertions(+), 34 deletions(-) diff --git a/Firmwares.md b/Firmwares.md index c94f7f10..9a6f43cd 100644 --- a/Firmwares.md +++ b/Firmwares.md @@ -2,7 +2,7 @@

Flipper Zero firmware differences

- :: Last updated July 27 2022. :: + :: Last updated Aug 3 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, @@ -14,12 +14,12 @@ Jump to: Official - RogueMaster Unleashed + RogueMaster + v1nc Wetox MuddledBox - v1nc - Summary / TL; DR + Summary (TL;DR)

Official flipperdevices/flipperzero-firmware @@ -29,7 +29,7 @@
  • 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.
    • +
  • 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.
    @@ -41,29 +41,41 @@
    • (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.
      • +
    • 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.
      • +
    • 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 proven-stable extra apps and plugins from the general community. +
      • More details and full list of changes can be found in their README.

    RogueMaster RogueMaster/flipperzero-firmware-wPlugins

      -
    • 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.
      • - +
    • 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 a number of games, some experimental only, as well as "Games Only Mode" (aka Dumb Mode).
      • +
    • Includes an enhanced, but experimental, new "Dolphin Level" system.
      • +
    • Has added most known community tweaks, plugins & games (some may be unstable or incomplete.)
      • +
    • Also includes a number of other small tweaks and changes.
      • +
      • More details and full list in their README.
      +
    +

    v1nc + v1nc/flipperzero-firmware + +

    +
      +
    • Supports different keyboard layouts for Duckyscripts via the script keyword DUCKY_LANG
      • +
    • Up to date fork of the Unleashed firmware
      • +
    • Includes community plugins & games

    Wetox wetox-team/flipperzero-firmware @@ -85,20 +97,11 @@
  • Adds self-promo images to about page in settings.
  • Adds a few extra common Sub-GHz frequencies to capture on.
    • -

    v1nc - v1nc/flipperzero-firmware - -

    -
      -
    • Supports different keyboard layouts for Duckyscripts via the script keyword DUCKY_LANG
      • -
    • Up to date fork of the Unleashed firmware
      • -
    • Includes community plugins & games
      • -
    -

    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 the core functionality and Sub-GHz protocols, only stable community apps are included.
      • -
    • RogueMaster has more community plugins and other small changes.
      • +
    • Unleashed is more focused on core functionality, stability, and Sub-GHz protocols.
      • +
    • RogueMaster has more community plugins, visual tweaks, games, and changes (some experimental).
    From db4057cd195fcc96e0d91ef4b7751ae73b818caa Mon Sep 17 00:00:00 2001 From: David Date: Thu, 4 Aug 2022 14:27:11 -0500 Subject: [PATCH 07/35] Update 45 (Closes #40) Co-authored-by: Tobia Bocchi --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 98c9d8ec..6b9c15cc 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,7 @@ - [`FlipperZero-Goodies` Intercom keys, scripts, etc.](https://github.com/wetox-team/flipperzero-goodies) - [`irplus database` Ripped from irplus App.](https://github.com/sasiplavnik/Flipper-IRDB) - [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer) +- [`flipperzero-bruteforce` Generate `.sub` files to brute force subghz OOK.](https://github.com/tobiabocchi/flipperzero-bruteforce) ## Applications & Plugins @@ -88,7 +89,9 @@ - [`WiFi Module v1 Case` Small cover for the WiFi dev board.](https://www.printables.com/model/179910-case-for-flipper-zero-wi-fi-module-v1) - [`Flipper screen protector` An alternative screen protector for Flipper.](https://www.photodon.com/p/2419-01.html) - [`WiFi Scanner Module` Scans for WiFi networks via a custom Wemos module board.](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module) +- [`WiFi Scanner Module Flasher` Web flasher for module firmware above.](https://sequoiasan.github.io/FlipperZero-WiFi-Scanner_Module/) - [`WiFi DSTIKE Deauther` Preforms WiFi deauth attacks via a custom ESP8266 module board.](https://github.com/SequoiaSan/FlipperZero-Wifi-ESP8266-Deauther-Module) +- [`WiFi Deauther Module Flasher` Web flasher for module firmware above.](https://sequoiasan.github.io/FlipperZero-Wifi-ESP8266-Deauther-Module/) - [`Skadis holder` Flipper Zero holder for Ikea Skadis.](https://www.thingiverse.com/thing:5434476) ## Off-device & Debugging @@ -106,6 +109,8 @@ - [`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) +- [`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) ## Notes & References From ccf4f3f97ccc21227b46eb3d7f287fc5620608ea Mon Sep 17 00:00:00 2001 From: Albert Gonzalez <2332870+theisolinearchip@users.noreply.github.com> Date: Fri, 5 Aug 2022 21:37:50 +0200 Subject: [PATCH 08/35] Update 46 Hex <-> Decimal converter (#44) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 6b9c15cc..c82b2e23 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,7 @@ - [`NRF24 & Mousejacking` PoC NRF24 library and mousejack exploitation app.](https://github.com/mothball187/flipperzero-nrf24) - [`UPC-A Barcode Generator` Can be used to create any UPC-A barcode.](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator) - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) +- [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) ## Firmwares & Tweaks From ef7c4ae770b51307e125d02ab494e02f5bb3994a Mon Sep 17 00:00:00 2001 From: Natanael Arndt Date: Tue, 9 Aug 2022 22:56:34 +0200 Subject: [PATCH 09/35] Update 47 Add musicxml2fmf (#47) * Add musicxml2fmf * Add music collection Add another smaller music collection --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c82b2e23..003ceb30 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,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) +- [`flipper-music-files` Much smaller collection of musics for FlipperZero Music Player.](https://github.com/Tonsil/flipper-music-files) - [`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) @@ -112,6 +113,7 @@ - [`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) ## Notes & References
    From 76d59af4238cfc8213e4c2cbd86b5c7d2e4d780b Mon Sep 17 00:00:00 2001 From: Eric Betts Date: Tue, 9 Aug 2022 13:56:59 -0700 Subject: [PATCH 10/35] Update 48 Add Legic Prime (#48) --- FAQ.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/FAQ.md b/FAQ.md index 6fd11793..657715bc 100644 --- a/FAQ.md +++ b/FAQ.md @@ -228,7 +228,8 @@ | H10301 | βœ… | | βœ… | βœ… | | | Indala | βœ… | | βœ… | βœ… | | | T5577 | βœ… | βœ… | βœ… | βœ… | | -| Paxton Net2 | ❌ | ❌ | ❌ | ❌ | Hitag2: no support | +| Paxton Net2 | ❌ | ❌ | ❌ | ❌ | Hitag2: no support | +| Legic Prime | ❌ | ❌ | ❌ | ❌ | 13.56mhz, but proprietary| ### 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). From e88133036ba759bcaed08aef6b357e3f4d6c2354 Mon Sep 17 00:00:00 2001 From: Brian Choromanski Date: Sun, 21 Aug 2022 09:59:29 -0400 Subject: [PATCH 11/35] Update 49 Added DrB0rk's Flipper Zero Daughterboards (#50) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 003ceb30..921900f9 100644 --- a/README.md +++ b/README.md @@ -95,6 +95,7 @@ - [`WiFi DSTIKE Deauther` Preforms WiFi deauth attacks via a custom ESP8266 module board.](https://github.com/SequoiaSan/FlipperZero-Wifi-ESP8266-Deauther-Module) - [`WiFi Deauther Module Flasher` Web flasher for module firmware above.](https://sequoiasan.github.io/FlipperZero-Wifi-ESP8266-Deauther-Module/) - [`Skadis holder` Flipper Zero holder for Ikea Skadis.](https://www.thingiverse.com/thing:5434476) +- [`Flipper Zero Boards` ESP32 and NRF24 daughterboards for the Flipper.](https://github.com/DrB0rk/Flipper-Zero-Boards) ## Off-device & Debugging - [`OOK to .sub` Python script to generate Flipper RAW .sub files from OOK bitstreams.](https://gist.github.com/jinschoi/f39dbd82e4e3d99d32ab6a9b8dfc2f55) From ba38b986ae49a8f1361c09a7446fcbec1b194963 Mon Sep 17 00:00:00 2001 From: David Date: Wed, 7 Sep 2022 21:53:59 -0500 Subject: [PATCH 12/35] Update 50 (Closes #49, Closes #51, Closes #52) Added FZ Car mount Added MultiConverter app Added USB-NFC FAQ entry Co-authored-by: David Sopas <11536578+dsopas@users.noreply.github.com> Co-authored-by: Albert Gonzalez <2332870+theisolinearchip@users.noreply.github.com> Co-authored-by: Eric Betts --- FAQ.md | 3 +++ README.md | 2 ++ 2 files changed, 5 insertions(+) diff --git a/FAQ.md b/FAQ.md index 657715bc..b6d25464 100644 --- a/FAQ.md +++ b/FAQ.md @@ -274,6 +274,9 @@ ### Why doesn't my bank card work when I emulate it? > EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. +### Where is the "USB NFC Reader" feature mentioned in the [september blog post](https://blog.flipperzero.one/september-progress/)? +> This was scrapped due to timing issues, more details in [this GitHub issue](https://github.com/flipperdevices/flipperzero-firmware/issues/1173#issuecomment-1127728562). + ## Infrared [πŸ”](#top) diff --git a/README.md b/README.md index 921900f9..c353f1dd 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,7 @@ - [`UPC-A Barcode Generator` Can be used to create any UPC-A barcode.](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator) - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) - [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) +- [`MultiConverter` Multi-unit converter that can be easily expanded with new units and conversion methods.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/multi_converter) ## Firmwares & Tweaks @@ -96,6 +97,7 @@ - [`WiFi Deauther Module Flasher` Web flasher for module firmware above.](https://sequoiasan.github.io/FlipperZero-Wifi-ESP8266-Deauther-Module/) - [`Skadis holder` Flipper Zero holder for Ikea Skadis.](https://www.thingiverse.com/thing:5434476) - [`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) ## Off-device & Debugging - [`OOK to .sub` Python script to generate Flipper RAW .sub files from OOK bitstreams.](https://gist.github.com/jinschoi/f39dbd82e4e3d99d32ab6a9b8dfc2f55) From c3261b36aa0cb84140891fc4c8dcc2ad20b3e65f Mon Sep 17 00:00:00 2001 From: David Date: Fri, 16 Sep 2022 07:35:58 -0500 Subject: [PATCH 13/35] Update 51 (Closes #54) Removed irplus database Added TPU cover Co-authored-by: UberGuidoZ <57457139+UberGuidoZ@users.noreply.github.com> Co-authored-by: Enrico Di Mauro --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c353f1dd..4e3d05db 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,6 @@ - [`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) -- [`irplus database` Ripped from irplus App.](https://github.com/sasiplavnik/Flipper-IRDB) - [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer) - [`flipperzero-bruteforce` Generate `.sub` files to brute force subghz OOK.](https://github.com/tobiabocchi/flipperzero-bruteforce) @@ -98,6 +97,7 @@ - [`Skadis holder` Flipper Zero holder for Ikea Skadis.](https://www.thingiverse.com/thing:5434476) - [`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) ## Off-device & Debugging - [`OOK to .sub` Python script to generate Flipper RAW .sub files from OOK bitstreams.](https://gist.github.com/jinschoi/f39dbd82e4e3d99d32ab6a9b8dfc2f55) From 0587adaf09d2e9a79260fa737f84e3d4dd14d59f Mon Sep 17 00:00:00 2001 From: David Date: Tue, 20 Sep 2022 09:11:44 -0500 Subject: [PATCH 14/35] Update 52 Many FAQ questions changed, still have a few things to write. --- FAQ.md | 101 ++++++++++++++++++++++++++++++++++++------------------ README.md | 13 ++----- 2 files changed, 69 insertions(+), 45 deletions(-) diff --git a/FAQ.md b/FAQ.md index b6d25464..0600d732 100644 --- a/FAQ.md +++ b/FAQ.md @@ -18,6 +18,7 @@ ## Preamble [πŸ”](#top) - *This is a community FAQ. Please consider also reading the [Official docs](https://docs.flipperzero.one/).* +- *It is written with information from the latest dev firmware, you may have to wait for a firmware (pre)release before some of the questions/answers become relevant.* - *This FAQ is still being worked on, and contributions are welcome.* - *If your question isn't answered here, **SEARCH** the [Discord](https://flipperzero.one/discord) and check pinned messages before asking there.* @@ -37,6 +38,11 @@ ### 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. +### This is really cool! Is there a way I can donate to you? +> I really appreciate the kind words, however I'm not accepting personal monetary donations. +> If you're really insistent, I'll accept a Discord Nitro gift ([`@DJ#9822`](https://discord.gg/9rduBhctJ6)) or Steam Game ([`/id/djsime1`](https://steamcommunity.com/id/djsime1/))! +> Besides that, why not support a local charity/organization instead? My personal recommendation is the [Electronic Frontier Foundation](https://supporters.eff.org/donate). + ## General [πŸ”](#top) @@ -57,40 +63,43 @@ > - For plugging the SD Card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). ### How do I install applications and plugins? -> The links listed in this repo can't be installed as easily as drag-and-drop. -> Most of them have to be manually merged into the firmware and fully recompiled. (Documentation coming soon) -> As for ELF/FAP's, they're in a very early stage of development and require a special version of the firmware to be installed. I DO NOT recommend using them until they are officially merged into the main firmware. -> *If you're really insistent, install the firmware from [this comment](https://github.com/flipperdevices/flipperzero-firmware/pull/1387#issuecomment-1182470778), place the `.elf` or `.fap` file in the `apps` directory on the SD Card (create it if necessary), and use the ELF loader application to run them.* - -### How do I write my own applications/plugins/firmware? -> *(WIP)* +> Assuming the application has been packaged as a `.fap` file, installing it is as easy as placing it inside the `apps` directory on your Flipper's SD card. You can launch the app from the `Applications` app. If the app hasn't been compiled into a `.fap`, either *kindly* ask the author or compile it yourself. ### How do I install custom firmwares? > First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? -> After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, always contains a file named `update.fuf`). +> After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, it always contains a file named `update.fuf`). > - If you only have a `.dfu`, it can be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. -> - If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create if needed). Once transferred, go to the idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. +> - If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create the folder if it doesn't already exist). Once transferred, go to the desktop/idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. > > If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. > For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). -### How do I compile my own firmware/applications/assets? -> *(WIP)* +### How do I write/compile my own applications/plugins/firmware/assets? +
    + (The following is a summary of the official FBT docs.)
    + Since the introduction of Flipper Build Tool (FBT), this has become very easy! You should have a basic understanding of working on a command line before proceeding. The only prerequisite install is Git. You should also have an IDE installed, VSCode is recommended since the firmware repo has config files for it. +
    + Expand me for the rest of the steps. + (WIP, sorry to curb your enthusiasm.) +
    +
    ### Can I make my own Flipper instead of buying one? -> Probably not. While the firwmare and schematics are mostly public, actually sourcing the components is extremely difficult. Multiple core pieces, such as the screen, were specficially produced to be used in Flipper manufacturing. +> Probably not. While the firmware and schematics are mostly public, actually sourcing the components is extremely difficult. Multiple core pieces, such as the screen, were specifically produced to be used in Flipper manufacturing. -### How do I get a black-case Flipper? -> This is no longer possible, they were Kickstarter-backer exclusives. +### How do I get a black-shell Flipper? +> This is no longer possible*, they were Kickstarter-backer exclusives. +> (*No longer possible unless you're willing to shill out hundreds of dollars for one on eBay.) ### How do I invert the screen/change backlight color/change case cover, etc. -> These are all hardware mods, inaccessible to the average user. Look up/ask around on how to do them. +> These are all hardware mods, generally inaccessible to the average user. Look up/ask around on how to do them if you're really interested, [r/flipperzero](https://old.reddit.com/r/flipperzero/) is a good place to start. ### Will there be future hardware revisions? -> [Not for the Flipper Zero.](https://discord.com/channels/740930220399525928/746304505879986267/1001167062728720395) While there are concepts for a [Flipper One](https://flipperzero.one/one), there is not any timeline for release. +> Technically speaking, there's going to be a **very minor** hardware revision in the near future. Functionally speaking, it will be identical to every other Flipper Zero already sold. The revision only replaces a few internal components and doesn't offer any new features compared to existing devices, so don't bother waiting to buy it. +> Besides that, there are concepts for a [Flipper One](https://flipperzero.one/one), but without a timeline for release. -### What is DUMB mode? -> It's a yet to be implimented mode that would hide all of the potentially malicious apps/features of Flipper. +### What is Dummy Mode? +> It's a work-in-progress feature that hides every app except games, in case your device is ever seized. ### My device is frozen, how do I reboot/fix it? > - To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. @@ -178,9 +187,8 @@ > Short answer: You don't. That's illegal, and NOT what Flipper was designed for. ### What does "This frequency can only be used for RX in your region" mean? -> Due to legal regulations, Flipper is not allowed to transmit on certain frequencies depending on your order location. -> For more information, referr to the [official documentation](https://docs.flipperzero.one/sub-ghz/frequencies) -> If you have no regard for laws, you can use custom firmwares such as Unleashed to bypass this restriction **at your own risk.** +> Due to legal regulations, Flipper is not allowed to transmit on certain frequencies depending on your device's provisioned location. +> Provisioning occurs whenever you update your firmware via qFlipper or the mobile app and is based on your rough location. ### How do I find the frequency of a device/transponder? > If it's a commonly used frequency, bring the device *really close* to the Flipper and use the Frequency analyzer. @@ -188,7 +196,8 @@ > Then, look up that ID on [FCC ID.io](https://fccid.io). ### I can't tune Flipper to capture a specific frequency. -> *(WIP)* +> You'll need to edit the `setting_user` and `setting_frequency_analyzer_user` to change the frequencies available for selection in the app. The files are located in `subghz/assets` on the SD card. +> Note that this won't magically unlock those frequencies, you're still bound by the device's limitations. ### I captured a garage/car/etc. signal, but it doesn't work when I replay it. > Unless the item of interest is extremely old, it probably uses rolling codes. Read more below. @@ -209,6 +218,10 @@ > Debruin sequences are more efficient by merging multiple codes together. > Example: 365, 136, and 650 can all be found in 13650 by looking at groups of 3 digits individually. +### Can I attach a more powerful antenna? +> Yes and no. You can't just attach any antenna directly via the GPIO pins, however you could use a separate processor on a protoboard and control it from Flipper, assuming you write your own code to do that. +> For example, you could write your own code on a NRF24 and accompanying Flipper app to control it over GPIO. + ## NFC & RFID [πŸ”](#top) @@ -224,13 +237,16 @@ | NTAG-21X | βœ… | | βœ… | βœ… | | | NFC-B | | | | ❌ | No hardware support for emulation | | iClass/PicoPass | βœ… | | βœ… | ❌ | No STM SDK support for emulation | -| EM4100/EM4102 | βœ… | | βœ… | βœ… | | -| H10301 | βœ… | | βœ… | βœ… | | -| Indala | βœ… | | βœ… | βœ… | | -| T5577 | βœ… | βœ… | βœ… | βœ… | | +| EM4100/EM4102 | βœ… | ❌ | βœ… | βœ… | | +| H10301 | βœ… | ❌ | βœ… | βœ… | | +| Indala | βœ… | ❌ | βœ… | βœ… | | +| T5577 | βœ… | βœ… | βœ… | βœ… | | +| EM4305 | βœ… | βœ… | βœ… | βœ… | | | Paxton Net2 | ❌ | ❌ | ❌ | ❌ | Hitag2: no support | | Legic Prime | ❌ | ❌ | ❌ | ❌ | 13.56mhz, but proprietary| +***Note:*** *While T5577 and EM4305's can be written, they are rarely handed out as ID badges.* + ### 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). @@ -239,22 +255,29 @@ > Note that you've only read the card UID and type, *not the actual data.* For that you need to select the "Run compatible app" option. ### Why can't I write an NFC tag? -> Currently unsupported, but is being worked on. +> This will become possible in the near future with a firmware update. -### Mifare Ultralight/NTAG was detected, but nothing happens when I'm trying to read the data. -> This happens when the tag is password protected. There's no quick fix for this, but solutions are in the works. +### 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. +> First, try reading the tag again but make sure it stays on the back of the device until the info screen pops up. +> If you're still seeing the warning, Flipper can unlock Amiibo and some Xaomi tags, but be warned that there's a risk of **bricking** your tag if you use the wrong password too many times. ### Why does it take so long to read a Mifare Classic? -> Mifare classics are split up into sectors, these sectors are protected by two keys. To read a Mifare Classic, Flipper uses a dictionary attack, which takes a big list currently comprised of about 2000 common keys, and checks them individually against each sector on the card. If you know the keys, they can be manually added to the User Dictionary under the "Extra Actions" menu. +> Mifare classics are split up into sectors, these sectors are protected by two keys. To read a Mifare Classic, Flipper uses a dictionary attack, which takes a big list currently comprised of 1241 common keys, and checks them individually against each sector on the card. If you know the keys, they can be manually added to the User Dictionary under the "Extra Actions" menu. ### What does it mean when no sectors could be read on a Mifare Classic? -> The data on Mifare Classic cards is split up into sectors, and each section is protected by two keys. -> The read has failed, meaning the card didn't use any common keys. If you have access to the card reader, [mfkey32v2](https://github.com/equipter/mfkey32v2) can be used to pull keys from it. +> The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. +> If no sectors were read, then Flipper's dictionary attack has failed to find any valid keys. +> If you know the keys, you can manually input them under the "Extra Actions" menu of the NFC app. Otherwise, try attacking the reader with mfkey32v2 as described a few questions down. ### What does it mean when some but not all sectors could be read on a Mifare Classic? > The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. > The read wasn't successful, but it didn't fail either. Some of the card's data was read and saved, but not all. -> Even if not all sectors were read, there's a slim chance a partial save will work with emulation. +> Even if not all sectors were read, you should inspect the dump with the mobile app to see if the missing data is necessary or not. In a few rare cases, semi-read cards can be emulated in place of the original without issue. +> If you still need the rest of the keys, read the next question. + +### How to I get Mifare Classic keys from a reader with [mfkey32v2](https://github.com/equipter/mfkey32v2)? +> (WIP, Note to self: https://regex101.com/r/iXmE2N/2) ### Why isn't Mifare Classic emulation working? > There are a number of reasons, some of which can be fixed while others can't. The first thing you should check is that all sectors were read from the card. If not, look at the questions above. @@ -274,7 +297,7 @@ ### Why doesn't my bank card work when I emulate it? > EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. -### Where is the "USB NFC Reader" feature mentioned in the [september blog post](https://blog.flipperzero.one/september-progress/)? +### Where is the "USB/LibNFC NFC Reader" feature mentioned in the [September blog post](https://blog.flipperzero.one/september-progress/)? > This was scrapped due to timing issues, more details in [this GitHub issue](https://github.com/flipperdevices/flipperzero-firmware/issues/1173#issuecomment-1127728562). @@ -295,3 +318,13 @@ ## BadUSB [πŸ”](#top) > *(WIP)* + + + +## iButton [πŸ”](#top) +> *(WIP)* + + + +## WiFi board [πŸ”](#top) +> *(WIP)* \ No newline at end of file diff --git a/README.md b/README.md index 4e3d05db..0c08dbae 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@
    - +
    OwO whats this?
    ✨ This section will be succeeded by
    Aquarium once SD-Card apps are released.
    ✨ This section will be succeeded by
    Aquarium in the near future.
    - [`Flipper-Plugin-Tutorial` Building a Custom "Hello world" plugin.](https://github.com/mfulz/Flipper-Plugin-Tutorial) @@ -119,11 +119,6 @@ - [`musicxml2fmf` Converts MusicXML files to Flipper Music Format.](https://github.com/white-gecko/musicxml2fmf) ## Notes & References - - - -
    Important notice.
    ⚠️ The Flipper team recently changed
    how the firmware is built. Some docs
    and tutorials may be outdated!
    - - [`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://github.com/djsime1/awesome-flipperzero/blob/main/Firmwares.md) @@ -148,9 +143,5 @@
    You can Edit this file and open a Pull Request, or Start a discussion with your ideas.
    - (A GitHub account is required for both) -
    - Why so many umerged 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. -
    + Read the Meta FAQ section for more info.
    From 600c1b0a8ccb3bc2c88a6b987caed96060e9f6cf Mon Sep 17 00:00:00 2001 From: David Date: Sun, 25 Sep 2022 12:30:59 -0500 Subject: [PATCH 15/35] Update 53 More Q&A stuff, added Aquarium call-to-action --- FAQ.md | 23 ++++++++++++++++++++--- Firmwares.md | 2 -- README.md | 6 +++--- 3 files changed, 23 insertions(+), 8 deletions(-) diff --git a/FAQ.md b/FAQ.md index 0600d732..67fd6ecf 100644 --- a/FAQ.md +++ b/FAQ.md @@ -74,6 +74,23 @@ > If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. > For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). +### Where and when are developer Q&A sessions held? +> Question and Answer session are held every week on Saturday, at 01:00 and 13:00 (GMT) +> +> | Time zone | Side A | Side B | +> | :------------: | :-----: | :-----: | +> | GMT/UTC | 01:00 | 13:00 | +> | Pacific (PDT) | 6:00 PM | 6:00 AM | +> | Mountain (MDT) | 7:00 PM | 7:00 AM | +> | Central (CDT) | 8:00 PM | 8:00 AM | +> | Eastern (EDT) | 9:00 PM | 9:00 AM | +> | China Standard | 09:00 | 21:00 | +> | India Standard | 06:30 | 18:30 | + +### Are there archives of past Q&A sessions? +> Archival is a community effort, so only some are available. +> [https://github.com/flipperdevices/flipper-questions-and-answers](https://github.com/flipperdevices/flipper-questions-and-answers) + ### How do I write/compile my own applications/plugins/firmware/assets?
    (The following is a summary of the official FBT docs.)
    @@ -280,9 +297,9 @@ > (WIP, Note to self: https://regex101.com/r/iXmE2N/2) ### Why isn't Mifare Classic emulation working? -> There are a number of reasons, some of which can be fixed while others can't. The first thing you should check is that all sectors were read from the card. If not, look at the questions above. -> On the hardware side: Mifare Classic emulation is handled by the CPU, except the clock cycle can't conform to the exact (and strict) timings that these tags communicate with. -> On the software side: Some rarely used card commands (counters, restore, and transfer) haven't been implimented, thus they will always fail during emulation. +> Flipper emulates Mifare Classics according to official specification docs (at 13.56 mhz), however certain card readers operate at slightly different frequencies (such as 13.50 mhz). Since Flipper is unable to detect the frequency (like a real card does), it also can't correct for these minor errors. +> As a result, data transmission doesn't always occur when the reader expects it, and thus emulation is imperfect. +> There are a few theoretical ways to fix this with software, but the best option would require hardware modification. ### Why can't I save/emulate Mifare DESFire? > DESFire is a very complicated and much more secure chipset. There are no known attacks against it yet. diff --git a/Firmwares.md b/Firmwares.md index 9a6f43cd..7f30aa20 100644 --- a/Firmwares.md +++ b/Firmwares.md @@ -1,5 +1,3 @@ -(Adapted from Nano's original messages in the Unleashed firmware Discord.) -

    Flipper Zero firmware differences

    :: Last updated Aug 3 2022. :: diff --git a/README.md b/README.md index 0c08dbae..5f9a0be9 100644 --- a/README.md +++ b/README.md @@ -51,9 +51,9 @@ ## Applications & Plugins - - - +
    OwO whats this?
    ✨ This section will be succeeded by
    Aquarium in the near future.
    + +

    πŸ“ž Calling all app developers! ✨

    Interested in publishing your app on Aquarium in the near future? Get in contact with me!
    - [`Flipper-Plugin-Tutorial` Building a Custom "Hello world" plugin.](https://github.com/mfulz/Flipper-Plugin-Tutorial) From bb1ab3efb8515adc84be22462aa2918cee3f2806 Mon Sep 17 00:00:00 2001 From: David Date: Sun, 25 Sep 2022 14:52:58 -0500 Subject: [PATCH 16/35] Update 54 (Closes #55, Closes #58, Closes #63) Co-authored-by: its-sven <96638100+its-sven@users.noreply.github.com> Co-authored-by: Felix Pankratz Co-authored-by: Gabi --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 5f9a0be9..e0241b31 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,10 @@ - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) - [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) - [`MultiConverter` Multi-unit converter that can be easily expanded with new units and conversion methods.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/multi_converter) +- [`Doom` Doom-like clone for Flipper Zero.](https://github.com/p4nic4ttack/doom-flipper-zero) +- [`bpm-tapper` Tap along to a song to measure beats per minute.](https://github.com/panki27/bpm-tapper) +- [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) +- [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) ## Firmwares & Tweaks @@ -117,6 +121,7 @@ - [`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) +- [`BadUSB keyboard converter` Payload converted for non-US keyboard layouts.](http://helppox.com/badusbconvert.html) ## Notes & References - [`Official battery self-repair guide` How to troubleshoot battery issues.](https://cdn.flipperzero.one/self-repair-guide.pdf) From 250dcabf5118a4e888e2d2187571543fbcdd90bd Mon Sep 17 00:00:00 2001 From: David Date: Mon, 26 Sep 2022 22:04:05 -0500 Subject: [PATCH 17/35] Update 55 Co-authored-by: BlackPropaganda <82137648+BlackPropaganda@users.noreply.github.com> --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e0241b31..7c4630a8 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ - [`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) - [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer) -- [`flipperzero-bruteforce` Generate `.sub` files to brute force subghz OOK.](https://github.com/tobiabocchi/flipperzero-bruteforce) +- [`flipperzero-bruteforce` Generate .sub files to brute force Sub-GHz OOK.](https://github.com/tobiabocchi/flipperzero-bruteforce) ## Applications & Plugins @@ -122,6 +122,7 @@ - [`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) - [`BadUSB keyboard converter` Payload converted for non-US keyboard layouts.](http://helppox.com/badusbconvert.html) +- [`U2F SSH Keys` U2F ECDSA SSH Key Generation using Flipper Zero.](https://gist.github.com/BlackPropaganda/44c40f7855a90e289a9477b654e54eb1) ## Notes & References - [`Official battery self-repair guide` How to troubleshoot battery issues.](https://cdn.flipperzero.one/self-repair-guide.pdf) From 2f46cf7eedac371e59f3e11ed20cff6d2ea4bab2 Mon Sep 17 00:00:00 2001 From: David Date: Mon, 3 Oct 2022 16:41:11 -0500 Subject: [PATCH 18/35] Update 56 (Closes #64) Added minesweeper, updated other documents. Co-authored-by: Felix Pankratz --- FAQ.md | 33 ++++++++++++++++++++++----------- Firmwares.md | 5 +++-- README.md | 1 + 3 files changed, 26 insertions(+), 13 deletions(-) diff --git a/FAQ.md b/FAQ.md index 67fd6ecf..de7ae138 100644 --- a/FAQ.md +++ b/FAQ.md @@ -11,8 +11,8 @@ NFC & RFID Infrared BadUSB - iButton - WiFi board + iButton + WiFi board @@ -67,9 +67,10 @@ ### How do I install custom firmwares? > First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? -> After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or updater package (typically a `.tar` or `.zip` file, it always contains a file named `update.fuf`). -> - If you only have a `.dfu`, it can be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. -> - If you have an updater package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create the folder if it doesn't already exist). Once transferred, go to the desktop/idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. +> After you've ignored the previous sentences, make sure there's a working MicroSD Card in your Flipper and head over to the repository of your perferred firmware. Look for releases and find the `.dfu` file or update package (typically a `.tar`, `.tar.gz`, or `.zip` file, it always contains a file named `update.fuf`). +> - If you only have a `.dfu`, it must be installed using the "Install from file" option in qFlipper. Select the file and begin the installation. +> - If you have an update package, you can either install it with qFlipper, or install it manually through the Micro SD card by following the steps below. +> - To manually install an update package, extract and transfer the folder (not the original archive file) to the `update` folder on the SD Card (create the folder if it doesn't already exist). Once transferred, go to the desktop/idle screen of the Flipper, press down to access the file browser, then left to view all folders. From there, open the `update` folder (typically at the bottom of the list) and find the folder you just transferred. Lastly, select the file named `update` and choose "Run in app" to install the firmware. > > If there was no pre-compiled update file/package, you'll have to build the firmware yourself. See the next question for details. > For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). @@ -116,7 +117,7 @@ > Besides that, there are concepts for a [Flipper One](https://flipperzero.one/one), but without a timeline for release. ### What is Dummy Mode? -> It's a work-in-progress feature that hides every app except games, in case your device is ever seized. +> Currently, it only allows the Snake game to be opened when active. In the future, it will hide every app except games, in case your device is ever inspected or seized. ### My device is frozen, how do I reboot/fix it? > - To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. @@ -268,8 +269,8 @@ > 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). ### How do I identify which type of NFC tag I have? -> Run the "Read card" action in the NFC app. If you don't see "NFC-A", your card is unfortunately unsupported. -> Note that you've only read the card UID and type, *not the actual data.* For that you need to select the "Run compatible app" option. +> 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. @@ -277,7 +278,7 @@ ### 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. > First, try reading the tag again but make sure it stays on the back of the device until the info screen pops up. -> If you're still seeing the warning, Flipper can unlock Amiibo and some Xaomi tags, but be warned that there's a risk of **bricking** your tag if you use the wrong password too many times. +> If you're still seeing the warning, Flipper can unlock *legally distinct NFC-enabled figurines that are pronounced like "Ameebo"* and Xaomi air filter tags, but be warned that there's a risk of **bricking** your tag if you use the wrong password too many times. ### Why does it take so long to read a Mifare Classic? > Mifare classics are split up into sectors, these sectors are protected by two keys. To read a Mifare Classic, Flipper uses a dictionary attack, which takes a big list currently comprised of 1241 common keys, and checks them individually against each sector on the card. If you know the keys, they can be manually added to the User Dictionary under the "Extra Actions" menu. @@ -312,7 +313,13 @@ > You'll need to use a NFC-enabled smartphone with an app that can write tags. One of the easiest to use apps is called NFC Tools, available for both [Android](https://play.google.com/store/apps/details?id=com.wakdev.wdnfc) and [iOS](https://apps.apple.com/us/app/nfc-tools/id1252962749). Due to Mifare Classic emulation quirks, you can only edit the data of saved NTAG and Mifare Ultralight tags. Create an empty NTAG216 with the "Add Manually" action in the NFC app if you don't have one already. Save that tag, then open it from the list. Once you start emulating the tag, you can use the NFC Tools smartphone app to write information on to the emulated tag. This is saved to a .shd file with the same name as the emulated tag. If you need a quick way to generate a tag containing a URL, you can use [Flipper Maker's NFC Creator tool](https://flippermaker.github.io/) online. ### Why doesn't my bank card work when I emulate it? -> EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. +> EMV Credit/Debit cards are mostly encrypted. The information Flipper reads is the unencrypted portion of the card. This alone is not enough to emulate and complete a transaction. It is impossible to read the encrypted parts. + +### Is there any way to save then emulate a bank card to authorize transactions? +> No, as explained in the previous question. + +### Can Flipper emulate a payment terminal and authorize transactions? +> No. Are you starting to see a pattern here? ### Where is the "USB/LibNFC NFC Reader" feature mentioned in the [September blog post](https://blog.flipperzero.one/september-progress/)? > This was scrapped due to timing issues, more details in [this GitHub issue](https://github.com/flipperdevices/flipperzero-firmware/issues/1173#issuecomment-1127728562). @@ -334,7 +341,11 @@ ## BadUSB [πŸ”](#top) -> *(WIP)* + +### I'm on a Non-US QWERTY keyboard, how do I make scripts work? +> Until a solution is put into the firmware, your best choice is trying one of the following converters: +> - [http://helppox.com/badusbconvert.html](http://helppox.com/badusbconvert.html) +> - [https://flippermaker.github.io/](https://flippermaker.github.io/) (BadUSB String To Alt Code) diff --git a/Firmwares.md b/Firmwares.md index 7f30aa20..8248e2b1 100644 --- a/Firmwares.md +++ b/Firmwares.md @@ -72,7 +72,7 @@
    • Supports different keyboard layouts for Duckyscripts via the script keyword DUCKY_LANG
      • -
    • Up to date fork of the Unleashed firmware
      • +
    • Out of date with upstream Unleashed firmware
    • Includes community plugins & games

    Wetox @@ -90,7 +90,7 @@

      -
    • Abandoned. Not updated for more than 2 months.
      • +
    • 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.
      • @@ -102,4 +102,5 @@
    • 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 has more community plugins, visual tweaks, games, and changes (some experimental).
      • +
    • RogueMaster is based on Unleashed, but may be less stable than Unleashed in some circumstances.
    diff --git a/README.md b/README.md index 7c4630a8..b6c9ec8c 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,7 @@ - [`bpm-tapper` Tap along to a song to measure beats per minute.](https://github.com/panki27/bpm-tapper) - [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) +- [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) ## Firmwares & Tweaks From 247252a7f802b2f0623f6c23981f5941aeb7ed5d Mon Sep 17 00:00:00 2001 From: David Date: Thu, 13 Oct 2022 15:38:41 -0500 Subject: [PATCH 19/35] Update 57 (Closes #65, Closes #66) Co-authored-by: UberGuidoZ <57457139+UberGuidoZ@users.noreply.github.com> --- Firmwares.md | 28 ++++++++++++++-------------- README.md | 9 ++++++--- 2 files changed, 20 insertions(+), 17 deletions(-) diff --git a/Firmwares.md b/Firmwares.md index 8248e2b1..03f7bc79 100644 --- a/Firmwares.md +++ b/Firmwares.md @@ -1,11 +1,11 @@

    Flipper Zero firmware differences

    - :: Last updated Aug 3 2022. :: + :: Last updated Oct 12 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 Awesome Flipper Zero list and my rant about the two types of Flipper users.

    @@ -33,7 +33,7 @@

    Unleashed - Eng1n33r/flipperzero-firmware + DarkFlippers/unleashed-firmware

      @@ -42,12 +42,12 @@
    • 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.
      • +
    • 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 proven-stable extra apps and plugins from the general community. -
      • More details and full list of changes can be found in their README.
      +
    • 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 @@ -60,10 +60,10 @@
  • 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 a number of games, some experimental only, as well as "Games Only Mode" (aka Dumb Mode).
    • +
  • Includes experimental "Games Only Mode" (aka Dumb Mode).
  • Includes an enhanced, but experimental, new "Dolphin Level" system.
    • -
  • Has added most known community tweaks, plugins & games (some may be unstable or incomplete.)
    • -
  • Also includes a number of other small tweaks and changes.
    • +
  • 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 @@ -71,9 +71,9 @@

      -
    • Supports different keyboard layouts for Duckyscripts via the script keyword DUCKY_LANG
      • -
    • Out of date with upstream Unleashed firmware
      • -
    • Includes community plugins & games
      • +
    • 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 @@ -101,6 +101,6 @@
  • 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 has more community plugins, visual tweaks, games, and changes (some experimental).
    • +
  • 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.
    • diff --git a/README.md b/README.md index b6c9ec8c..bba2e036 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@

    Interested in publishing your app on Aquarium in the near future? Get in contact with me!
    -- [`Flipper-Plugin-Tutorial` Building a Custom "Hello world" plugin.](https://github.com/mfulz/Flipper-Plugin-Tutorial) +- [`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) - [`Flappy Bird` The name says it all.](https://github.com/DroomOne/flipperzero-firmware/tree/dev/applications%2Fflappy_bird) @@ -72,6 +72,7 @@ - [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) - [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) +- [`SD Load Applications` Prebuilt applications (FAP) for popular firmware options.](https://github.com/UberGuidoZ/Flipper/tree/main/Applications) ## Firmwares & Tweaks @@ -80,8 +81,8 @@ πŸ”° Click here for a feature
    comparison of these firmwares!     -- [`Unleashed` Frequency-unlocked firmware with rolling codes support & community plugins.](https://github.com/Eng1n33r/flipperzero-firmware) -- [`RogueMaster` Unleashed + Official FW fork with assorted community plugins, tweaks, & games.](https://github.com/RogueMaster/flipperzero-firmware-wPlugins) +- [`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) - [`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) @@ -105,6 +106,7 @@ - [`Soft TPU cover` Similar to the official silicone case.](https://www.printables.com/en/model/272676-soft-tpu-flipper-zero-cover) ## Off-device & Debugging +- [`Official Web Interface` Web interface to interact with Flipper, including Paint and SUB/IR analyzer.](https://my.flipp.dev/) - [`OOK to .sub` Python script to generate Flipper RAW .sub files from OOK bitstreams.](https://gist.github.com/jinschoi/f39dbd82e4e3d99d32ab6a9b8dfc2f55) - [`csv2ir` Script to convert IRDB CSV's to Flipper .ir files.](https://github.com/Spexivus/csv2ir) - [`flipperzero-sesproject` Segger Embedded Studio project.](https://github.com/hedger/flipperzero-sesproject) @@ -142,6 +144,7 @@ - [`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) - [`Flipper Skylanders` How to read a Skylanders figure with Flipper.](https://github.com/V0lk3n/Flipper-Skylanders) +- [`Flipper Zero Dimensions` Basic info on screen and case dimensions.](https://github.com/UberGuidoZ/Flipper/tree/main/FlipperZero_Dimensions) From 464c01bb712b0209ff6505728a51e6527aa28cb2 Mon Sep 17 00:00:00 2001 From: Igor Bespalov Date: Sun, 16 Oct 2022 21:18:51 +0300 Subject: [PATCH 20/35] Update 58 Added Tuning Fork (#67) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index bba2e036..36ed1166 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,7 @@ - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) - [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) - [`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) ## Firmwares & Tweaks From 1ec36b930636a0fd43f4d4aa20578a3e79b48072 Mon Sep 17 00:00:00 2001 From: David Date: Wed, 26 Oct 2022 17:12:04 -0500 Subject: [PATCH 21/35] Update 59 (Closes #68, Closes #69) Co-authored-by: UNC0V3R3D <115997296+UNC0V3R3D@users.noreply.github.com> Co-authored-by: Aaron Mavrinac Co-authored-by: Alexander Koz --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 36ed1166..78cc1c3b 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,7 @@ - [`FlipperZero-Goodies` Intercom keys, scripts, etc.](https://github.com/wetox-team/flipperzero-goodies) - [`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) ## Applications & Plugins @@ -73,7 +74,8 @@ - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) - [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) - [`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) +- [`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) ## Firmwares & Tweaks @@ -127,6 +129,8 @@ - [`musicxml2fmf` Converts MusicXML files to Flipper Music Format.](https://github.com/white-gecko/musicxml2fmf) - [`BadUSB keyboard converter` Payload converted for non-US keyboard layouts.](http://helppox.com/badusbconvert.html) - [`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) ## Notes & References - [`Official battery self-repair guide` How to troubleshoot battery issues.](https://cdn.flipperzero.one/self-repair-guide.pdf) From 48981ef642bfde7473b2dfe95b4d317f10b24fb3 Mon Sep 17 00:00:00 2001 From: David Date: Thu, 24 Nov 2022 14:13:18 -0600 Subject: [PATCH 22/35] Update 60 (Closes #70, Closes #71, Closes #73) Co-authored-by: Patrizio Bekerle Co-authored-by: GLUTEN <57950551+GlUTEN-BASH@users.noreply.github.com> Co-authored-by: Alexander Kopachov --- FAQ.md | 59 +++++++++------ Firmwares.md | 199 ++++++++++++++++++++++++++++++--------------------- README.md | 17 +++-- 3 files changed, 163 insertions(+), 112 deletions(-) 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) + Iceman firmware 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.

    - - - - - - - - - -
    - Jump to: - OfficialUnleashedRogueMasterv1ncWetoxMuddledBoxSummary (TL;DR)
    -

    Official - flipperdevices/flipperzero-firmware - +

    + This document maintains a list of differences between various forks of the + Flipper Zero firmware. +

    + + + + + + + + + + + +
    + Jump to: + OfficialUnleashedRogueMasterv1ncWetoxMuddledBoxSummary (TL;DR)
    +

    + βœ… Official + + flipperdevices/flipperzero-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 - +

    + πŸ”“ 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 - +

    + πŸ’« 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 - +

    + ⌨ 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 - +

    + 🎩 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 - +

    + πŸ“¦ 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 - - - - -

    πŸ“ž Calling all app developers! ✨

    Interested in publishing your app on Aquarium in the near future? Get in contact with me!
    - - [`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) From 1ed28b1bdde04a492e94bba5c11168b86056508b Mon Sep 17 00:00:00 2001 From: David Date: Sun, 4 Dec 2022 20:20:44 -0600 Subject: [PATCH 23/35] Update 61 (Closes #74, Closes #75, Closes #76) Co-authored-by: Ari Bytyqi <101530102+Z3BRO@users.noreply.github.com> Co-authored-by: its-sven <96638100+its-sven@users.noreply.github.com> Co-authored-by: Eric Betts Co-authored-by: maehw --- FAQ.md | 7 ++++++- README.md | 4 ++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/FAQ.md b/FAQ.md index aad77a99..96e4f146 100644 --- a/FAQ.md +++ b/FAQ.md @@ -343,7 +343,12 @@ ### Where is the "USB/LibNFC NFC Reader" feature mentioned in the [September blog post](https://blog.flipperzero.one/september-progress/)? > This was scrapped due to timing issues, more details in [this GitHub issue](https://github.com/flipperdevices/flipperzero-firmware/issues/1173#issuecomment-1127728562). - +### Where can I learn more about NFC and RFID technology? +> - Introduction to both Low Frequency and High Frequency: https://blog.flipperzero.one/rfid/ +> - Types of NFC https://www.rfwireless-world.com/Tutorials/NFC-Type1-Tag-vs-NFC-Type2-Tag-vs-NFC-Type3-Tag-NFC-Type4-Tag-Types.html +> - Mifare Classic: https://learn.adafruit.com/adafruit-pn532-rfid-nfc/mifare +> - The Mifare Family: https://en.wikipedia.org/wiki/MIFARE +> - Datasheets: http://www.proxmark.org/files/Documents/ ## Infrared [πŸ”](#top) diff --git a/README.md b/README.md index 10119ca5..fe3b2539 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,8 @@ - [`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) +- [`FalsePhilosophers Flipper BadUSB` Flipper zero community ducky payload repo.](https://github.com/FalsePhilosopher/badusb) +- [`SerialHex2FlipperZeroInfrared` Convert IR serial messages into FlipperZero compatible IR files.](https://github.com/maehw/SerialHex2FlipperZeroInfrared) ## Applications & Plugins - [`Flipper-Plugin-Tutorial` Updated plugin tutorial based on new build methods.](https://github.com/csBlueChip/FlipperZero_plugin_howto) @@ -105,6 +107,7 @@ - [`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) +- [`WiFi Devboard Pelican Case` Top case that works with the 4mm FZ Pelican case.](https://github.com/Z3BRO/Flipper-Zero-Pelican-Case-Wifi-Devboard) ## Off-device & Debugging - [`Official Web Interface` Web interface to interact with Flipper, including Paint and SUB/IR analyzer.](https://my.flipp.dev/) @@ -150,6 +153,7 @@ - [`Flipper Skylanders` How to read a Skylanders figure with Flipper.](https://github.com/V0lk3n/Flipper-Skylanders) - [`Flipper Zero Dimensions` Basic info on screen and case dimensions.](https://github.com/UberGuidoZ/Flipper/tree/main/FlipperZero_Dimensions) +
    From a6f5ed9ddadb74d0ca9facd4038cbf5ec0769e66 Mon Sep 17 00:00:00 2001 From: David Date: Wed, 28 Dec 2022 23:20:26 -0600 Subject: [PATCH 24/35] Update 62 (Closes #77, Closes #79) Co-authored-by: Victor Nikitchuk Co-authored-by: Kyhwana Pardus Co-authored-by: Ari Bytyqi <101530102+Z3BRO@users.noreply.github.com> --- FAQ.md | 2 ++ README.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/FAQ.md b/FAQ.md index 96e4f146..08c61c82 100644 --- a/FAQ.md +++ b/FAQ.md @@ -349,6 +349,8 @@ > - Mifare Classic: https://learn.adafruit.com/adafruit-pn532-rfid-nfc/mifare > - The Mifare Family: https://en.wikipedia.org/wiki/MIFARE > - Datasheets: http://www.proxmark.org/files/Documents/ +> - Common RFID Standards and protocols: https://www.asiarfid.com/common-rfid-standards-and-protocols.html +> - RFID Standards: ISO, IEC, EPCglobal: https://www.electronics-notes.com/articles/connectivity/rfid-radio-frequency-identification/standards-iec-iso-epcglobal.php ## Infrared [πŸ”](#top) diff --git a/README.md b/README.md index fe3b2539..9f777b46 100644 --- a/README.md +++ b/README.md @@ -75,6 +75,7 @@ - [`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/) +- [`Unitemp` Application for reading temperature, humidity and pressure sensors using Onewire, Singlewire, I2C protocols](https://github.com/quen0n/unitemp-flipperzero) ## Firmwares & Tweaks @@ -108,6 +109,7 @@ - [`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) - [`WiFi Devboard Pelican Case` Top case that works with the 4mm FZ Pelican case.](https://github.com/Z3BRO/Flipper-Zero-Pelican-Case-Wifi-Devboard) +- [`RGB Backlight mod` Replace your Flipper LCD's backlight with Adafruit Neopixels.](https://github.com/Z3BRO/Flipper-Zero-RBG-Backlight) ## Off-device & Debugging - [`Official Web Interface` Web interface to interact with Flipper, including Paint and SUB/IR analyzer.](https://my.flipp.dev/) From 3429a3fd91a4be5de8626c2bc2e7642dc029f3df Mon Sep 17 00:00:00 2001 From: Patrizio Bekerle Date: Fri, 30 Dec 2022 01:09:58 +0100 Subject: [PATCH 25/35] Add "fzfs" Flipper Zero filesystem driver link (#70) Co-authored-by: David --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f777b46..33afa0df 100644 --- a/README.md +++ b/README.md @@ -134,7 +134,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) +- [`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) From bb8f944f00ea90204504adcf76b733c2fcf3a28a Mon Sep 17 00:00:00 2001 From: Patrizio Bekerle Date: Fri, 30 Dec 2022 01:10:51 +0100 Subject: [PATCH 26/35] Add link to "USB HID Autofire" (#71) Co-authored-by: David --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 33afa0df..f543fa7a 100644 --- a/README.md +++ b/README.md @@ -74,8 +74,6 @@ - [`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/) -- [`Unitemp` Application for reading temperature, humidity and pressure sensors using Onewire, Singlewire, I2C protocols](https://github.com/quen0n/unitemp-flipperzero) ## Firmwares & Tweaks From ba935215740aab51e703394052ad3e94d6996374 Mon Sep 17 00:00:00 2001 From: GLUTEN <57950551+GlUTEN-BASH@users.noreply.github.com> Date: Fri, 30 Dec 2022 03:11:27 +0300 Subject: [PATCH 27/35] Add Universal Intercom Keys repo (#73) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index f543fa7a..6f2dabab 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,7 @@ - [`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) +- [`Flipper-StarNew` Universal Intercom Keys](https://github.com/GlUTEN-BASH/Flipper-Starnew) - [`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) From 8b414bab1a8de444c3dedb89e0be734f5f271fd9 Mon Sep 17 00:00:00 2001 From: Aaron Mavrinac Date: Thu, 29 Dec 2022 19:12:34 -0500 Subject: [PATCH 28/35] Add GPS app. (#69) Co-authored-by: David --- README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 6f2dabab..8edaae81 100644 --- a/README.md +++ b/README.md @@ -72,9 +72,8 @@ - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) - [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) - [`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) +- [`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) ## Firmwares & Tweaks From 2bb29390745a4c8732c842e6eb4735297e93dd2d Mon Sep 17 00:00:00 2001 From: Felix Pankratz Date: Fri, 30 Dec 2022 01:14:15 +0100 Subject: [PATCH 29/35] Update README.md (#64) Add Minesweeper. Co-authored-by: David --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 8edaae81..2af17d40 100644 --- a/README.md +++ b/README.md @@ -71,9 +71,6 @@ - [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) - [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) - [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) -- [`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) ## Firmwares & Tweaks From 068181d8c83d71159ae0c9af091ffbd385a8de46 Mon Sep 17 00:00:00 2001 From: Gabriel Cirlig Date: Thu, 29 Dec 2022 19:15:23 -0500 Subject: [PATCH 30/35] add USB keyboard (#63) Co-authored-by: David --- README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/README.md b/README.md index 2af17d40..db09ff4f 100644 --- a/README.md +++ b/README.md @@ -66,11 +66,7 @@ - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) - [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) - [`MultiConverter` Multi-unit converter that can be easily expanded with new units and conversion methods.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/multi_converter) -- [`Doom` Doom-like clone for Flipper Zero.](https://github.com/p4nic4ttack/doom-flipper-zero) -- [`bpm-tapper` Tap along to a song to measure beats per minute.](https://github.com/panki27/bpm-tapper) -- [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) -- [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the Flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) -- [`Minesweeper` Minesweeper implementation.](https://github.com/panki27/minesweeper) +- [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) ## Firmwares & Tweaks From 1679c32ab58a1995c804c75e9fb91e56ad1d7070 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sven=20W=C3=BCrth?= <96638100+its-sven@users.noreply.github.com> Date: Fri, 30 Dec 2022 01:16:01 +0100 Subject: [PATCH 31/35] Added DOOM | Update README.md (#58) * Update README.md * Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index db09ff4f..69c675a8 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,7 @@ - [`flipper-music-files` Much smaller collection of musics for FlipperZero Music Player.](https://github.com/Tonsil/flipper-music-files) - [`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) +- [`FalsePhilosophers Flipper BadUSB` Flipper zero community ducky payload repo.](https://github.com/FalsePhilosopher/badusb) - [`FlipperZero-Goodies` Intercom keys, scripts, etc.](https://github.com/wetox-team/flipperzero-goodies) - [`Flipper-StarNew` Universal Intercom Keys](https://github.com/GlUTEN-BASH/Flipper-Starnew) - [`T119 bruteforcer` Triggers Retekess T119 restaurant pagers.](https://github.com/xb8/t119bruteforcer) @@ -57,6 +58,7 @@ ## 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) +- [`Doom` Doom Flipper Zero edition.](https://github.com/p4nic4ttack/doom-flipper-zero) - [`Tetris` A rudimentary Tetris game.](https://github.com/jeffplang/flipperzero-firmware/tree/tetris_game/applications/tetris_game) - [`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) From 3ac7c0c1fc202632ad969d9e56ee6f54f84f3546 Mon Sep 17 00:00:00 2001 From: Felix Pankratz Date: Fri, 30 Dec 2022 01:17:11 +0100 Subject: [PATCH 32/35] Update README.md (#55) * Update README.md Added link to my BPM tapper :) * Update README.md add metronome Co-authored-by: David --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 69c675a8..c25c239b 100644 --- a/README.md +++ b/README.md @@ -68,7 +68,8 @@ - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) - [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) - [`MultiConverter` Multi-unit converter that can be easily expanded with new units and conversion methods.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/multi_converter) -- [`USB Keyboard` A refactor of the BT remote to work over USB. Allows the flipper to act as an USB HID keyboard.](https://github.com/huuck/FlipperZeroUSBKeyboard) +- [`bpm-tapper` Tap along to a song to measure beats per minute.](https://github.com/panki27/bpm-tapper) +- [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) ## Firmwares & Tweaks From 20a03e40a08e4dbc90771f764bed72f51383e742 Mon Sep 17 00:00:00 2001 From: Eric Betts Date: Thu, 29 Dec 2022 16:17:44 -0800 Subject: [PATCH 33/35] Update FAQ.md (#52) Add Question about usb nfc Co-authored-by: David --- FAQ.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/FAQ.md b/FAQ.md index 08c61c82..0a8b8e14 100644 --- a/FAQ.md +++ b/FAQ.md @@ -340,17 +340,9 @@ ### Can Flipper emulate a payment terminal and authorize transactions? > No. Are you starting to see a pattern here? -### Where is the "USB/LibNFC NFC Reader" feature mentioned in the [September blog post](https://blog.flipperzero.one/september-progress/)? +### Where is the "USB NFC Reader" feature mentioned in the [september blog post](https://blog.flipperzero.one/september-progress/)? > This was scrapped due to timing issues, more details in [this GitHub issue](https://github.com/flipperdevices/flipperzero-firmware/issues/1173#issuecomment-1127728562). - -### Where can I learn more about NFC and RFID technology? -> - Introduction to both Low Frequency and High Frequency: https://blog.flipperzero.one/rfid/ -> - Types of NFC https://www.rfwireless-world.com/Tutorials/NFC-Type1-Tag-vs-NFC-Type2-Tag-vs-NFC-Type3-Tag-NFC-Type4-Tag-Types.html -> - Mifare Classic: https://learn.adafruit.com/adafruit-pn532-rfid-nfc/mifare -> - The Mifare Family: https://en.wikipedia.org/wiki/MIFARE -> - Datasheets: http://www.proxmark.org/files/Documents/ -> - Common RFID Standards and protocols: https://www.asiarfid.com/common-rfid-standards-and-protocols.html -> - RFID Standards: ISO, IEC, EPCglobal: https://www.electronics-notes.com/articles/connectivity/rfid-radio-frequency-identification/standards-iec-iso-epcglobal.php + ## Infrared [πŸ”](#top) From 8b80307e627a0eaf549e4f3b4ea56cfdcff7f7b4 Mon Sep 17 00:00:00 2001 From: Albert Gonzalez <2332870+theisolinearchip@users.noreply.github.com> Date: Fri, 30 Dec 2022 01:18:35 +0100 Subject: [PATCH 34/35] Added MultiConverter app entry (#51) I've added an improved multi converter app based on my previously work with the Dec/Hex Converter. I didn't remove the previous Dec/Hex Converter entry, but chances are that all the updates related to this project will be made only on the MultiConverter app (that also includes a Dec/Hex converter option too). Co-authored-by: David --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index c25c239b..509e510a 100644 --- a/README.md +++ b/README.md @@ -68,8 +68,6 @@ - [`Sentry Safe` Plugin that can open any Sentry Safe and Master Lock electronic safe without entering pin code.](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin) - [`Dec/Hex Converter` Small "real time" decimal/hexadecimal converter.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/dec_hex_converter) - [`MultiConverter` Multi-unit converter that can be easily expanded with new units and conversion methods.](https://github.com/theisolinearchip/flipperzero_stuff/tree/main/applications/multi_converter) -- [`bpm-tapper` Tap along to a song to measure beats per minute.](https://github.com/panki27/bpm-tapper) -- [`Metronome` Musical metronome.](https://github.com/panki27/Metronome) ## Firmwares & Tweaks From fd23d075cdca6ae66cbfc12ef41b60123df9c268 Mon Sep 17 00:00:00 2001 From: tobiabocchi Date: Fri, 30 Dec 2022 01:20:41 +0100 Subject: [PATCH 35/35] Add flipperzero-bruteforce to Databases & Dumps (#40) Co-authored-by: Tobia Bocchi Co-authored-by: David