Skip to content

Install Firmware and Apps

Jump to bottom
Derek Jamison edited this page Feb 12, 2024 · 32 revisions

Install Firmware and Apps

I just created this page. I will update and create video for Feb 17th, 2024.

Overview

This page is about how you can build applications for your firmware. These applications are called FAP files, which stands for Flipper Application Package. The FAP file has a required API version, which is why you need it to match the API of the firmware you are running on your Flipper. You can read more about FAP files in the official documentation.

Techniques

There are many techniques to accomplish the various tasks. At the beginning of this document we will focus on using a command-line interface, but you can also accomplish these tasks using Visual Studio Code (which allows you to pick commands to run from a nice user interface, instead of memorizing command-line parameters). There are also multiple tools, such as uFBT and FBT. At the beginning of this document, we will use the FBT instead of uFBT tool.

Prerequisites (Required apps)

  • Required: We use the Git command (and the Git tools with VS Code). This is pre-installed in Kali. If it is not already installed for your OS, you can download from Git tools download
  • Required for uFBT only: Python 3.8 or newer is needed for installing uFBT. You can install from Python download
  • Optional: Visual Studio Code is nice editor. You can install from VS Code download

Clone firmware

We need the SDK API version to match what we are running on our Flipper Zero. The easiest way to accomplish this is to recursively clone the firmware we are running on the Flipper. Many people choose to run a custom firmware instead of the official firmware. We will update our Flipper firmware, so you can follow this step to switch to a different firmware.

Step 1: Open a command terminal.

  • In Kali, this is called Terminal Emulator
  • In Windows, this is called Command Prompt.

Step 2: Change into whatever directory you want to put the files.

  • In Kali:
    • First time: mkdir repo to make a repo folder.
    • Every time: cd repo
  • In Windows:
    • First time: mkdir c:\repo to make a repo folder.
    • Every time: cd c:\repo

Step 3: Recursively clone the firmware you want to use.

  • Official firmware:
    • git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git
    • cd flipperzero-firmware
  • RogueMaster firmware:
    • git clone --recursive https://github.com/RogueMaster/flipperzero-firmware-wPlugins.git roguemaster-firmware
    • cd roguemaster-firmware
  • Unleashed firmware:
    • git clone --recursive https://github.com/DarkFlippers/unleashed-firmware
    • cd unleashed-firmware
  • Xtreme firmware:
    • git clone --recursive https://github.com/Flipper-XFW/Xtreme-Firmware.git xtreme-firmware
    • cd xtreme-firmware

Step 4: Choose the branch

  • Official:
    • Release branch: (Stable release)
      • git checkout release
    • Release candidate branch: (Release being tested)
      • git checkout release-candidate
    • Dev branch: (Latest version, may be unstable)
      • git checkout dev
  • RogueMaster: 420 (Latest version)
    • git checkout 420
  • Unleashed:
    • Release branch: (Stable release)
      • git checkout release
    • Dev branch: (Latest, may be unstable)
      • git checkout dev
  • Xtreme
    • Main branch: (Stable release)
      • git checkout main
    • Dev branch: (Latest, may be unstable)
      • git checkout dev

Step 5 (Optional): Install VS Code support

The following command will update the .vscode folder so that it has all of the required files for VS Code. If you have VS Code installed on your computer, I recommend doing this step, so that later if you choose to use VS Code you will already have the Flipper support files.

  • Kali: ./fbt vscode_dist
  • Windows: fbt vscode_dist

Step 6: Backup your files

It's always possible that you could lose data, so be sure to backup any files from the SD card that you care about (like captured subghz files, nfc files, etc.) Some people do Settings/Storage/Unmount SD Card before ejecting the SD card, then they put it computer to copy the files. Once they are done, they put the SD card back into the Flipper Zero. NOTE: You can also use the mobile app to backup files or the qFlipper app to backup files, you can install from this Flipper Zero download page.

Step 7: Build and deploy firmware

Make sure your Flipper Zero is not running any applications (press Back putting until you are at the desktop). Make sure your Flipper Zero is connected to your computer.

  • Kali: ./fbt COMPACT=1 DEBUG=0 FORCE=1 flash_usb_full
  • Windows: fbt COMPACT=1 DEBUG=0 FORCE=1 flash_usb_full
Clone this wiki locally