/Xtreme-Firmware

The Dom amongst the Flipper Zero Firmware. Give your Flipper the power and freedom it is really craving. Let it show you its true form. Dont delay, switch to the one and only true Master today!

Primary LanguageCGNU General Public License v3.0GPL-3.0

XFW - Xtreme Firmware for the Flipper Zero

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



What makes it special?

We have spent many hours perfecting this code even further, and getting the most out of it.

The goal of this Firmware is to regularly bring out amazing updates based on what the community wants, with an actual understanding of whats going on. Fixing bugs that are regularly talked about, removing unstable / broken applications (.FAP) and actually using the level system that just sits abandoned everywhere else.

  • Feature-rich: We include all commonly found apps in the firmware, as long as they work.

  • Stable: Many hours have been spent rewriting core parts of the Flippers firmware as well as some of its apps to ensure stability. A task that was long needed on all Firmware, so we tackled it right away.

  • Customizable: Dont like the Animations, want to turn on/off the Home screen icons (battery, SD card etc), change the flippers name or anything like that? You absolutely can. No need to mess with code or deal with weird manifest files. Its all done with an App.



Note, the below mentioned changes are only a few things we did. For a full list click here



Xtreme Settings:

We wrote a powerful yet easy-to-use application specifically for our Firmware, that gives you easy-access to all the fancy things we implemented:

  • Interface: Customize every bit of your Flipper, from the desktop animations, to the main menu apps, lockscreen style etc.

  • Protocols: Here you can toggle between USB & Bluetooth mode for BadKB, and manage custom Subghz frequencies.

  • Misc: All the other options that don't fit elsewhere. Change your Flipper's name, xp level, and configure the RGB backlight.




Animations / Asset Packs:

Want to try some asset packs? Check here

We created our own, new & improved Animation / Asset system, that we can finally reveal. 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, or find some user made ones in the discord channel. Check here for a tutorial on creating your own. Essentially, we got our own Anims & Icons folders, inside each Asset Pack.

Once you have some packs, upload them to your Flipper in SD/asset_packs (if you did this right you should see SD/asset_packs/PackName/Anims and/or SD/asset_packs/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 for all apps (e.g. Subghz scanning asset) & animations!


Bad Keyboard:

BadUSB is a wonderful app, but it lacks bluetooth capabilities. Now some might argue that its useless as you will always need authentication from both sides, but what if I told you that we found a solution to this problem?

Bad-KB allows you to toggle between USB and Bluetooth mode for your attacks. In Bluetooth mode it allows you to spoof the name & MAC of the device to whatever you want. Being a JBL speaker or a wireless razer keyboard is easily doable, allowing you to trick people so you can run your payloads without needing a cable at hand.

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:

Note: This repo is always updated with OFW & Unleashed. No need to mention all those here. We will only mention our changes that we can actually be credited for.

[Added]

- Xtreme App
- Asset Packs
- More UI options
- Bad-Keyboard App
- A new battery display-type
- Scrolling view for long file names in browser
- Advanced and optimized level system. Read more above
- Folder handling for empty ones (Now indicate they are empty)

- Custom subghz presets
- Multiple NFC protocols
- Multiple Sub-Ghz protocols | Merged from Unleashed, thanks @xMasterX
- Subghz and IR signal replication via gpio | Credits to @xMasterX

- New API Routes for Locale settings
[Updated]

- All Assets

- Tons of apps
- File browser
- Massive compiler re-do
- About 4k files to speed things up a lot
- Applications to now use the new Locale setting
[Fixed]

- Keyboard issues on first char
- Passport crash on high level
- SFW / 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


Install:


There are 3 methods to install Xtreme, we recommend you use the Web Updater, but choose whichever one you prefer:


Web Updater (Chrome)
  • Open the latest release page and click on the Web Updater link
  • Make sure qFlipper is closed
  • Click Connect and select your Flipper from the list
  • Click Flash and wait for the update to complete
qFlipper Package (.tgz)
  • Download the qFlipper package (.tgz) from the latest release page
  • Open qFlipper and connect your Flipper
  • Click Install from file
  • Select the .tgz you downloaded and wait for the update to complete
Zipped Archive (.zip)
  • Download the zipped archive (.zip) from the latest release page
  • Extract the archive. This is now your new Firmware folder
  • Open qFlipper, head to SD/Update and simply move the firmware folder there
  • On the Flipper, hit the Arrow Down button, this will get you to the file menu. In there simply search for your updates folder
  • Inside that folder, select the Firmware you just moved onto it, and run the file thats simply called Update



Build it yourself:

Warning We will not give basic support for compiling in our server. This is intended for people that already know what they are doing!

To download the needed tools:
$ git clone --recursive --jobs 8 https://github.com/Flipper-XFW/Xtreme-Firmware.git
$ cd Xtreme-Firmware/

To flash directly to the Flipper (Needs to be connected via USB, qFlipper closed)
$ ./fbt flash_usb_full

To compile a TGZ package
$ ./fbt updater_package

To build and launch a single app:
$ ./fbt launch APPSRC=some_appid

Stargazers over time

Stargazers over time


Contributors

Contributors

❤️ Support

If you like what you're seeing, please consider donating to us. We won't ever put this behind a paywall, but we'd still appreciate a few bucks!

  • Patreon: ❤️ Account needed, subscription with perks across my entire org.
  • Wire-transfer: No account needed, one-time
  • Paypal: Account needed, one-time
  • ko-fi: No account needed, one-time
  • Monero: 41kyWeeoVdK4quzQ4M9ikVGs6tCQCLfdx8jLExTNsAu2SF1QAyDqRdjfGM6EL8L9NpXwt89HJeAoGf1aoArk7nDr4AMMV4T

Thanks for all your support <3


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