Flipper zen

Flipper Zero Files 0.3.1

This is a carefully curated collection of various Flipper Zero resources combined into a single repository for my own research and learning as a Computer Engineer and now AI Graduate Student.

First, I install the DarkFlippers' Unleashed firmware. Next, all relevent apps in the new official Flipper Labs Flipper App Store are installed. Finally, all the additional files here from the cfwFiles are then added for all the extra "goodies".

If you have a Flipper Zero device, I suggest the following:

• Rule #1: Don't do anything stupid or illegal on any devices that are not YOUR OWN.
• Rule #2: Know your appropriate governing agency's laws/regulations on Wireless Spectrum alocation. Here in the US, we have the FCC part 15 which deals with 'unlicensed' spectrum in various bands, included in which are:
  • 315MHz | 433 MHz | 915 MHz
• I am also a radio Amateur, so I am afforded FCC Part 97 as well. YMMV.

If none of this makes sense to you, then you probably should not own or be using a Flipper Zero device.

This repo is divided into different folders:

• cfwFiles contains a collection of files from each of the sources listed below, but are cleaned up and organized for use with my personal Flipper Zero device. This folder has been trimmed to get rid of non-flipper device files (see below) for minimum SD space requirements. README.md files have been preserved for credit along with any other file that describes functionality or ownership/contributorship.

  • The files in this folder are meant to be drop-in add-ons for the existing Unleashed Firmware, so it contains all the applications and other related files for all the latest functionality.

• myFiles contains my personal remote codes from devices that are no longer working. This is for my personal research. Please use responsibly. These files are also already added to the cfwFiles folder.

• fapSource contains all the Flipper App source code file from the various repositories I listed here. Any of this code should compile into a .fap application. I tried to keep everything organized for future reference. This may be interesting to someone (like me) interested in Flipper Zero application development.

• otherFiles are any other Flipper Zero related files that are not mine, like 3D print case files, protoboard files, and things that do not need to get saved to the Flipper's SD Card.

Files not included in this repo are:

• Animations.
• Music.
• Firmware Packages.

These items are irrelevent to my work and are easily found elsewhere.

Files in this repo that I did not create myself are also linked to below.

Firmware I use:

• DarkFlippers' Unleashed Firmware.

Flipper Zero Firmware Resources:

• New official Flipper Lab Flipper App Store.
• ESP32 WiFi Marauder Companion App.
  • Note that install instructions are also here: UberGuidoZ's Marauder Install Information.
  • Note that the evilPortal server app has been integrated with 0xchocolate's Flipper Zero WiFi Marauder Companion App.

Flipper Zero Device Repo File Sources:

Apps and Scripts:

• iakat's Awesome Flipper Zero Pack.
• djsime's Awesome Flipper Zero.
• theisolinearchip's Flipper Zero Stuff.
• Z3BRO's FzDumps.
• xMasterX's All The Plugins.
• UberGuidoZ's Flipper.
• UberGuidoZ's Flipper IRDB.
• SHUR1K-N's Sub GHz Jamming.
• hak5's O.MG Payloads.
• I-Am-Jakoby's Flipper Zero BadUSB.
• MuddledBox's FlipperZeroSub-GHz README.md file for deBruijn usage information.

Flipper Zero DevBoard Sources:

• FZ Docs: How to Update Firmware on the FZ Official DevBoard (OFW).

• UberGuidoZ's Wifi_DevBoard Repo full of useful information for the DevBoard.

• justcallmekoko's Flipper Zero WiFi Dev Board SD Expansion

• justcallmekoko's Flipper Zero WiFi Dev Board SD-GPS Expansion. Associated Repos:

  • ESP32 Marauder Repo.
  • Marauder Wiki for FZ WiFi Dev Board.
  • Marauder Wiki Evil Portal use fir WiFi sniffing. The Evil Portal was a standalone app, but is now integrated with the Marauder Software.
  • Marauder Wiki Select EP HTML File which allows selection of custom portal HTML page for phishing attacks.

• blackmagic-debug's Black Magic Probe Debugger Repo.

• Mini Module NRF24L01: A Plug 'n Play NRF24 Module for sniffing WiFi and other 2.4GHz

  • nRF24L01+ Single Chip 2.4GHz Transceiver Data Sheet.
  • Some other documentation on the NRF24 Module.

Other Flipper Resources:

• FZEEFlasher: An online web based GUI for flashing Flipper Zero and Dev Boards.
  • FZEEFlasher GitHub Wiki Page.
• Momentum FW web installer for the new Momentum Firmware.
• Derek Jamison's YouTube Playlist for Flipper Zero Sub-GHz describes some more advanced Sub-GHz signal capturing and playback.
• CyberSecurityUP's Awesome Flipper Zero 2 : A collection of useful Flipper Zero resources.
• TI CC1101 Data Sheet : Used for the FZ SubGHz Transceiver module.
  • Note the frequency limitations of the CC1101 according to the datasheet:
    • 300 - 348 MHz | 387 - 464 MHz | 779 - 928 MHz.
  • The TI CC1101 supports the following modulation schemes:
    • (G)FSK | 2(G)FSK | 4(G)FSK | ASK | OOK.
• ST STM32WB55RG Overview and Data Sheet for the STM32 32-bit ARM Cortex-M4 64MHz MCU used for the Flipper Zero.
• ST ST25R3916 Overview and Data Sheet for the High performance NFC universal device and EMVCo reader used for the Flipper Zero.
• HCS301 Data Sheet for SubGHz KeeLoQ® Code Hopping Encoder for Remote Keyless Entry (RKE) Systems.

Flipper App Development:

• jamisonderek's Flipper Zero Tutorials repository.
• m1ch3al's Flipper Zero Dev Tutorial : How To develop apps for the Flipper Zero (GitHub & Linux based).
• Flipper Maker : Generate .sub Flipper files for Apps.

Under Development:

• Flipper Zero .fap Factory : A cloud-based one-click tool to build Flipper Zero .fap applications from git repositories. (used to work, currently says "under construction")
• bigbrodude6119's Flipper Zero Evil Portal: not currently working with latest firmware (Update: has been integrated into Marauder CFW with the Marauder Companion App.)
  • Also note kleo's Evil Portals pages for phishing attacks.

My FZ SD Card File Structure:

• Source: FlipperDevices Readme
• Modifications are mine.

/ext/ [FLIPPER SD (Unleashed CFW)]
│
├── apps/                           ## Put all your `.fap` files in one of these appropriate subfolders.
│   ├── Games/
│   ├── GPIO/
│   ├── Media/
│   ├── Main/
│   ├── Misc/
│   ├── NFC/
│   ├── Settings/
│   ├── Sub-GHz/
│   └── Tools/
│
├── apps_assets
│   ├── ble_spam
│   ├── crypto_dict
│   └── barcode_app
│
├── apps_data
│   ├── barcodes
│   ├── btremote_kodi
│   ├── flipper_xremote
│   └── subghz
│

Status:

DISCLAIMER:

ONLY use this repo at your own risk on your own devices, and do not violate the law with any of these apps. You should only transmit on frequencies that you are authorized to do so. It is the final user's responsibility to obey all applicable local, state & federal laws. I assume no liability and are not responsible for any misuse or damage by you. In the US, refer to the FCC for radio spectrum info if you are unsure of that information. This repo is FOR EDUCATIONAL USE ONLY. If you get in trouble doing something stupid, especially jamming or causing interference, then YOU are the only one to blame. I have not been able to test everything in this repo yet, since this is a work in progress, so USE AT YOUR OWN RISK.