website logo
HomeShopDocsBlogForum
⌘K
Flipper Zero Documentation
Basics
🐬First start
MicroSD card setup
Firmware update
Pet dolphin
Power
Reboot
Controls
Settings
Sub-GHz
Reading signals
Reading RAW signals
Adding new remotes
Supported Sub-GHz vendors
Frequencies
125 kHz RFID
Reading 125 kHz RFID cards
Adding 125 kHz cards manually
Writing data to T5577 cards
Animal microchips
NFC
Reading NFC cards
Recovering keys with MFKey32
Unlocking cards with passwords
Writing data to magic cards
Infrared
Reading infrared signals
Using universal remotes
GPIO & modules
iButton
Bad USB
U2F (Universal 2nd Factor)
Apps
HID controllers
Flipper Mobile App
Reporting Mobile App bugs
qFlipper
Troubleshooting drivers on Windows
Development
Hardware
Blueprints
Docs powered by
Archbee
Basics

Firmware update

Document image


We are constantly updating the Flipper Zero firmware, which is why it is important to update your Flipper Zero regularly. You can update your Flipper Zero via the Flipper Mobile App or qFlipper.

There are three firmware update channels:

  • DEVELOPMENT (Dev): The ongoing development is constantly building a new version of the firmware with every new commit, often multiple times per day. This Development version includes all the latest features, but it may be unstable, cause freezing or corruption of your data, or fail to function altogether.
  • RELEASE-CANDIDATE (RC): The version submitted for validation testing to the QA department. If any bugs are detected during the testing phase, the version is revised, and a new Release candidate is issued. Once the release candidate successfully passes all tests, it becomes the Release version.
  • RELEASE: The stable version of the firmware is extensively tested to ensure its reliability and is therefore recommended for general use.
<div class="warning flipper-callout">
    <div class="callout-header">Insert a microSD card before the update procedure</div>
    A microSD card must be inserted into your Flipper Zero to update the firmware correctly. Flipper Zero databases are stored on a microSD card. To learn more, see <a href="https://docs.flipperzero.one/basics/sd-card" onclick="next.router.push('https://docs.flipperzero.one/basics/sd-card')"><u>MicroSD card setup</u>.
</div>


You can find the changelog for the Flipper Zero firmware by visiting this page.



Updating via Flipper Mobile App

With the Flipper Mobile App, you can update your Flipper Zero via Bluetooth. The application is available on iOS and Android:

<style>
    .app-links {
        width: 100%;
        display: flex;
        flex-wrap: wrap;
        justify-content: space-evenly;
    }
    .app-links > a {
        margin: 1rem 0;
        background-repeat: no-repeat;
        background-size: contain;
    }
    .app-links > a:first-of-type {
        width: 224px;
        height: 75px;
        background-image: url(https://cdn.flipperzero.one/App_Store_Badge_svg.svg);
    }
    .app-links > a:last-of-type {
        width: 242px;
        height: 74px;
        background-image: url(https://cdn.flipperzero.one/Google_Play_Badge__svg.svg);
    }
</style>
<div class="app-links">
    <a href="https://apps.apple.com/app/flipper-mobile-app/id1534655259"></a>
    <a href="https://play.google.com/store/apps/details?id=com.flipperdevices.app"></a>
</div>


Connecting to Flipper Zero

After you downloaded the Flipper Mobile App and activated Bluetooth on your phone, connect the mobile application to your Flipper Zero:

1

Activate Bluetooth on your Flipper Zero by following these steps:

1) Go to Main Menu -> Settings -> Bluetooth.

2) Set Bluetooth to ON.

2

In the Flipper Mobile App, tap Connect.

3

On the next page, next to the detected Flipper Zero's name, tap Connect.

You can connect Flipper Zero to your phone via Bluetooth
You can connect Flipper Zero to your phone via Bluetooth

4

In the Flipper Mobile App, enter the pairing code displayed on the Flipper Zero screen.

5

Tap Pair to finalize pairing.

If your Flipper Zero is not detected

  • Make sure Bluetooth is activated on your Flipper Zero. -> How to turn on Bluetooth on Flipper Zero.
  • Check the Bluetooth connection on your phone.
  • Disconnect Flipper Zero from other devices. -> How to forget all paired devices on Flipper Zero.
  • Update Flipper Zero to the latest firmware version. It is important to update your Flipper Zero regularly. -> How to update the firmware on Flipper Zero.
  • Check if the latest version of the Flipper Mobile App is installed on your phone. -> App Store or Google Play.
  • Reboot your Flipper Zero. -> How to reboot Flipper Zero.

Updating Flipper Zero

To update your Flipper Zero via the Flipper Mobile App, do the following:

1

In the Main Menu tab, tap Update Channel and select a firmware (Release is recommended).

2

Tap the Update button.

3

Tap the Update button to confirm the action.

The update process via the Flipper Mobile App usually takes 2-3 minutes.



You can update your Flipper Zero via the Flipper Mobile App
You can update your Flipper Zero via the Flipper Mobile App


If Flipper Zero update failed

  • Check the Bluetooth connection with your Flipper Zero.
  • Make sure your Flipper Zero is turned on.
  • If your Flipper Zero doesn't respond, reboot it. -> How to reboot Flipper Zero.
  • Restart firmware update.
  • Update your Flipper Zero via qFlipper.


Updating via qFlipper

With qFlipper, you can update firmware, manage files, and repair corrupted firmware
With qFlipper, you can update firmware, manage files, and repair corrupted firmware


qFlipper is a desktop application that allows you to update your Flipper Zero via a USB cable. The qFlipper application is available on Windows, macOS, and Linux. To install the qFlipper application on your computer, do the following:

1

Download the qFlipper installation file for your operating system.

<style>
    .qf-download-btn {
        display: flex;
        flex-direction: column;
        justify-content: center;
        width: 310px;
        height: 86px;
        text-align: center;
        color: #ffffff;
        font-size: 22px;
        line-height: 1.55;
        border-radius: 10px;
        background-color: #1faa20;
        transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out, border-color 0.2s ease-in-out;
    }
    .qf-download-btn img {
        display: inline;
    }
</style>
<div style="display: flex; justify-content: center;">
    <a class="qf-download-btn" href="current"><span style="font-size: 125%;">Download qFlipper</span><span>for macOS</span></a>
</div>
<script>
    (() => {
      const qFlipper = { version: '', links: { macOS: '', Windows: '', Linux: '' } }
      let os = 'Windows'
      if (navigator.userAgent.includes('Macintosh')) { os = 'macOS' } else if (navigator.userAgent.includes('Linux') && !navigator.userAgent.includes('Android')) { os = 'Linux' } else { os = 'Windows' }
      function findLatest (versions) {
        let max = 0
        versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        return versions.find(e => e.timestamp === max)
      }
      fetch('https://update.flipperzero.one/qFlipper/directory.json').then((response) => { return response.json() }).then(data => {
        const release = data.channels.find(e => e.id === 'release')
        let max = 0
        release.versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        const latest = findLatest(release.versions)
        qFlipper.version = latest.version
        qFlipper.links.macOS = latest.files.find(e => e.target === 'macos/amd64').url
        qFlipper.links.Windows = latest.files.find(e => e.target === 'windows/amd64' && e.type === 'installer').url
        qFlipper.links.Linux = latest.files.find(e => e.target === 'linux/amd64').url
        document.querySelector('[href="current"]').innerHTML = '<span style="font-size: 125%;">Download qFlipper</span><span>for <img style="position: relative;top: -2px;margin: 0px 2px 0 8px;" src="https://cdn.flipperzero.one/' + os + '-white-logo.svg"/> ' + os + '</span>'
        document.querySelector('[href="current"]').setAttribute('href', qFlipper.links[os])
        document.querySelector('[href="macOS"]').setAttribute('href', qFlipper.links.macOS)
        document.querySelector('[href="Windows"]').setAttribute('href', qFlipper.links.Windows)
        document.querySelector('[href="Linux"]').setAttribute('href', qFlipper.links.Linux)
      })
      fetch('https://update.flipperzero.one/firmware/directory.json').then((response) => { return response.json() }).then(data => {
        const dev = data.channels.find(e => e.id === 'development')
        const rc = data.channels.find(e => e.id === 'release-candidate')
        const release = data.channels.find(e => e.id === 'release')
        let latest = findLatest(dev.versions)
        document.querySelector('[href="dev"]').innerHTML = 'Dev Unstable   <span style="color: rgb(253, 36, 36);">' + latest.version + '</span>'
        document.querySelector('[href="dev"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(rc.versions)
        document.querySelector('[href="rc"]').innerHTML = 'Release Candidate   <span style="color: rgb(135, 42, 204);">' + latest.version + '</span>'
        document.querySelector('[href="rc"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(release.versions)
        document.querySelector('[href="release"]').innerHTML = 'Latest Release   <span style="color: rgb(59, 207, 70);">' + latest.version + '</span>'
        document.querySelector('[href="release"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
      })
    })()
</script>


You can also download qFlipper on the Flipper Zero Firmware update page.

2

Run the downloaded file and follow the instructions for your operating system.

%windows%Windows
%mac%macOS
%linux%Linux

For Windows, the qFlipper application is compatible with Windows 10 and 11 only.



qFlipper is available on Windows
qFlipper is available on Windows




The qFlipper application is compatible with macOS version 10.14 or later. The application is optimized for M1 Apple Silicon Macs.

qFlipper is available on macOS
qFlipper is available on macOS




For Linux, the qFlipper application is downloaded in the AppImage format. Before running the application on Linux, you need to make the application executable:

Using the GUI

1

In the file manager, right-click the downloaded file.

2

Go to Properties -> Permissions.

3

Click the ‘Allow executing file as program’ checkbox if you are using a Nautilus-based file manager (Files, Nemo, Caja), or click the ‘Is executable’ checkbox if you are using Dolphin, or change the ‘Execute’ drop-down list to ‘Anyone’ if you are using PCManFM.

4

Close the dialog.

5

Double-click on the AppImage file to run.



Using the Terminal

1

Open the Terminal.

2

Change to the directory containing the AppImage file.

3

Make the AppImage executable:chmod +x filename.AppImage.

4

Run the AppImage:./filename.AppImage.



Set up udev rules

After making the application executable via the GUI or Terminal, you will need to set up udev rules in order to use qFlipper as a normal user:

./qFlipper-x86_64.AppImage rules install [/optional/path/to/rules/dir]

Updating Flipper Zero

To update your Flipper Zero via the qFlipper application, do the following:

1

Connect your Flipper Zero to your computer via a USB cable.

2

On your computer, run the qFlipper application.

3

In the qFlipper application, go to the Advanced controls tab.

4

Click Update Channel and select a firmware version from the drop-down list (Release is recommended).

5

Click Update to start the update process.

Update your Flipper Zero via qFlipper
Update your Flipper Zero via qFlipper



Can't update the firmware of your Flipper Zero? Check out the following pages:

Internal storage repair

Firmware recovery



Updated 11 Sep 2023
Did this page help you?
PREVIOUS
MicroSD card setup
NEXT
Internal storage repair
Docs powered by
Archbee
TABLE OF CONTENTS
Updating via Flipper Mobile App
Connecting to Flipper Zero
If your Flipper Zero is not detected
Updating Flipper Zero
If Flipper Zero update failed
Updating via qFlipper
Updating Flipper Zero
Docs powered by
Archbee

Community

Kickstarter Habr.com Discord Forum Blog

For developers

Documentation GitHub Design Guide

Distributors

Lab401 Joom How to buy Become a Partner

About

Contacts Jobs Compliance Company Abuse Report Privacy Policy

Copyright © 2023 Flipper Devices Inc.