Skip to content
This repository has been archived by the owner on Apr 23, 2023. It is now read-only.

Latest commit

 

History

History
375 lines (306 loc) · 18 KB

ReadMe.md

File metadata and controls

375 lines (306 loc) · 18 KB

FZ Fusion Firmware


CODENAME: Purposeful Porpoise

Made Possible By:

This firmware is a complete overhaul of the Official Firmware, it also features lots of awesome code-bits from Unleashed.



What makes FZ Fusion special?

This is a fork of a fork of a fork. XFW Team spent many hours perfecting this code even further, and getting the most out of it. I just spent time screwing bolts into its neck...

This fork of Xtreme Firmware includes a HUGE RESOURCE LIBRARY with custom modifications and additions.

Thanks to FlipperZero, ClaraCrazy and XFW Contributors, Unleased Team, RogueMaster, UberGuidoZ, and many more!

This firmware is xtra thicc because it attempts to include and organize many public asset repos that provide IR, SUB, NFC, IBTN, and other resources. I do not recommend this for well established Flippers! However if you are a new Flipper Operator and would like to take a quick shortcut, this will flash faster than you will find and aggragate all the included resource files.

If you just want the Resources check assets/resources and have fun!


P.S. I'm not here for drama, your money, or recognition. Hack4Peace! XO

Support the Upstream Project - XFM (Not Mine)

If you like Xtreme Firmware and wish to help out, please contribute to the project ❤️

  • Patreon
  • Monero: 41kyWeeoVdK4quzQ4M9ikVGs6tCQCLfdx8jLExTNsAu2SF1QAyDqRdjfGM6EL8L9NpXwt89HJeAoGf1aoArk7nDr4AMMV4T



Roadmap:

Desimpification! Clara is great! The stock Xtreme assets... Not so much. Also simplify, expand, unify, and make the FlipperZero a PRO device.

Full roadmap: https://github.com/IamUSER/Flipper-Fusion/blob/main/documentation/roadmap.md

Xtra [Xtreme] Settings:

XFW adds a powerful yet easy-to-use settings application, that gives you easy-access to the followign features:

Base Graphics: Change the fallback assets used. Its either OEM (default) or PRO
Asset Pack: Allows you to easily customize your firmware, more on that below
Anim Speed: Speed in which the animations play
Cycle Anims: Duration of how long animations are played before switching to next
Unlock Anims: Custom setting just for PRO fallback animations.
Battery Icon: Classic Firmware battery style toggle, just at a more convenient place
XP Level: Changes your Flippers level
SubGhz Extend: Allows you to extend the subghz range beyond what FZ devs planned. (Potential Hardware Damage!)
SubGhz Bypass: Allows you to bypass the subghz region locks of the Flipper




Animations / Asset Packs:

XFW adds a new & improved Animation / Asset system. It lets you to create and cycle through your own Asset Packs with only a few button presses, allowing you to easily load custom Animations and Icons like never before.

You can easily create your own pack. Check here for a tutorial on creating your own. Essentially, add your own Anims & Icons folders, inside each Asset Pack.

Once you have some packs, upload them to your Flipper in SD/dolphin_custom (if you did this right you should see SD/dolphin_custom/PackName/Anims and/or SD/dolphin_custom/PackName/Icons).

After installing the packs to Flipper, hit the Arrow UP button on the main menu and go to Xtreme Settings. Here choose which pack you want and tweak the other settings how you prefer, then press back to reboot and enjoy your new assets & animations!


Levels:

This Firmware has 30 levels, not just the basic 3 the official one has.

With this new system in place, it allows for some cool stuff like locking animations behind a certain level. This can be done fairly easy: The idle_animations are tied to the level system. Specifically, the Min level variable of your manifest file is used here. Each level you reach, unlocks a new animation. The higher your level, the more animations people can see.



List of changes added to Official Firmware:

Note: This repo is always updated with select Xtreme Firmware main branch commits. Thank you to everyone who contribues!

Full(ish) changelog: https://github.com/IamUSER/Flipper-Fusion/blob/main/documentation/changelog.md

[Added in Fusion]

- Mifare files.
- Edit stock Xtreme Firmware to suit my maniacal ends.
- Make GUI more PRO.
- Add Asset Packs - Squatch, RM, Unleashed, etc.
- Restored the Status Bar!
- New Animations! (Feat. John Cena!)
- AirTag Emulator Firmware Mod added to resources. Not implemented! (https://github.com/culturally/flipper-zero-airtag)
- A plethora of useful assets for IR, SUB, NFC, IBTN, RFID, etc.
- A Thicc Sub Repo - https://github.com/SONNYRZ/Sub-GHz-Files-Flipper-Zero-
- Touchtunes Jukebox Remotes - https://github.com/jimilinuxguy/flipperzero-touchtunes
- OOK Bruteforcer - https://github.com/tobiabocchi/flipperzero-bruteforce
- Intercom RFID's - (https://github.com/wetox-team/flipperzero-goodies)
- t119 Bruteforcer - (https://github.com/xb8/t119bruteforcer)
- H10301 Bruteforce - (https://github.com/UberGuidoZ/Flipper)
[Added in XFW]

- Xtreme App
- Asset Packs
- More UI options
- A new battery display-type
- Scrolling view for long file names in browser
- NSFW Animations tied to the level system. Read more above
- Folder handling for empty ones (Now indicate they are empty)
- SFW Mode (OEM Mode in Fusion)
- Xtreme App
- Asset Packs
- More UI options
- A new battery display-type
- Scrolling view for long file names in browser
- PRO Animations tied to the level system. Read more above
- Folder handling for empty ones (Now indicate they are empty)
- Jamming Files
- Custom subghz presets
- Multiple NFC protocols
- Multiple Sub-Ghz protocols | Merged from Unleashed, thanks @xMasterX
- Subghz and IR signal replication via gpio | Credits to @ankris812
- Honda Keys (CVE-2022-27254) & Ford blockers
- New API Routes for Locale settings
[Updated]

- Graphics Adjustments
- Folder handling for empty ones (Now indicate they are empty)
- Applications now use the new Locale setting
- Compiler now handles all non-compiled faps during build
- Compiler now accepts WIP SDK 
- Compiler just stfu about non-fatal problems
- Some further NFC stuff
- Weather App
- Applications now use above mentioned API Routes
- All Assets
- Tons of apps
- File browser
- Massive compiler re-do
- About 1k files to speed things up a lot
- Applications to now use the new Locale setting
[Fixed]

- Bootloop and DFU Crashfix by jbohack
- Passport crash on high level
- OEM / Dummy_mode getting you XP
- Leveling system
- Mood system
[REMOVED]

- Unused Dummy Mode
- Broken apps (bad apple, chess, etc.)
- Tons of unused code from FAPs and system calls

Manual Install

  • Download the latest release (.zip) from The releases tab
  • Extract the archive. This is now your new Firmware folder
  • Insert SD card into your PC and add the whole firmware folder to SD/Update and reinsert SD into the FlipperZero
  • Power on the Flipper, hit the Arrow Down button, this will get you to the file menu. Hit Arrow Left once to enter the Browser, and then simply search for the 'updates' folder
  • Inside that folder, select the Firmware folder you just added, and run the file thats simply called Update



Install this mutant firmware by building it yourself:

Freshest commits are in the Reactor branch!



Requires USB Flash or Builtin Updater App! Builtin updater is added to most custom firmware.

(Step 1)
To download the needed tools:
$ git clone --recursive https://github.com/IamUSER/Flipper-Fusion.git
$ cd Flipper-Fusion/

(Step 2)
Build apps:
$ ./fbt fap_dist

(Step 3)
Build resources:
$ ./fbt resources dolphin_ext

(Step 4)
Build firmware:
$ ./fbt COMPACT=1 DEBUG=0 updater_package

(Step 5 - Optional for rebuilds!)
Clean Build Cache (Repeat Step 4 afterward.)
$ ./fbt COMPACT=1 DEBUG=0 updater_package -c

(Step 6 - Preferred flash method!)
To flash directly to the Flipper (Needs to be connected via USB, qFlipper closed.)
After Firmware flash unpack resources.tar to SD. This is faster than Step 7.
$ ./fbt flash_usb

(Step 7 - Requires a custom firmware with builtin updater already be installed!)
Copy new firmware from the dist/f7-C/FZFusionx.xx.x?x folder to FlipperSD/updates.
Run the builtin updater in the same manner you update other custom firmware.
Wait for 2 hours! Unfortunately SD to SD updates take forever to unpack 220MB. 

NOTE: If you are coming from a different/older firmware and encounter application errors, it is recommended to overwrite the "apps" folder on the SD card after updating by unpacking the "apps" folder from the resources.tar to the SD card. This folder houses all the .fap files, which may not update to the correct API versions by default. This does NOT remove any of your saved files! If you have custom apps installed you should know what you're doing.

If you dont like the default asthetic, Xtreme Firmware added a SFW mode (OEM Mode in Fusion) to the Firmware. From the main menu, hit Arrow UP and select OEM Mode and now all assets will be stock.

Reenable PRO mode with the steps listed below

  • Navigate to the main screen
  • Press the UP button on the Flipper
  • Press the 'PRO Mode' toggle


Awesome contributers and community additions ❤️

GPIO

Games

Misc

Music

Tools



Known Bugs:

- After upgrading to multiple different firmware your Flipper may run out of builtin memory. If you cannot update this is likely the case. You will need to clear your internal storage from the Settings > Storage Menu. You may lose settings and XP! Use the Xtra Settings to readjust your XP as needed.



Credits:

- FlipperZero Team - Stock Firmware and the epic FlipperZero!
- ClaraCrazy - Xtreme Firmware
- DarkFlippers - Unleashed Firmware and Apps
- RogueMaster - w/Plugins
- UberGuidoZ - Centralizer of quality flipper files!


Contributors

Contributors


"What we do for ourselves dies with us. What we do for others and the world remains and is immortal.” ― Albert Pine