qFlipper
qFlipper is a desktop application for updating Flipper Zero firmware and databases, managing files on the microSD card, and repairing corrupted firmware. qFlipper is available on Windows, macOS, and Linux.
On this page, you’ll find an overview of the application and learn how to install it on your PC. You’ll also learn how to update and control your Flipper Zero and report qFlipper issues.
To install the qFlipper application on your computer, do the following:
Download the qFlipper installation file for your operating system.
You can also download qFlipper from the Flipper Zero Firmware update page.
Run the downloaded file and follow the instructions for your operating system.
For Windows, the qFlipper application is compatible with Windows 10 and 11 only.
After you’ve installed the qFlipper application on your computer, connect your Flipper Zero (with an inserted microSD card) to your computer via a USB cable.
In the Device information tab, you can view the main information about Flipper Zero hardware and installed firmware, update the device, and control it remotely.
In the Advanced control tab, you can back up, restore, and reset your Flipper Zero, as well as choose firmware to install on the device. Similar to the Device information tab, you can control your Flipper Zero and initiate the update procedure. See Internal storage repair to learn more about backup and restoration procedures.
In the File manager tab, you can delete, rename, and upload files to Flipper Zero. You can easily navigate through files with the keyboard arrow keys.
To upload files in the File manager tab, drag and drop files to the desired folder or right-click the required folder and click Upload here.
You can easily navigate in the File manager tab using only a keyboard:
Command | Keys on %windows%Windows and %linux%Linux | Keys on %mac%macOS |
|---|---|---|
Enter | Return | Return |
Back | Backspace | Backspace |
Upload | Ctrl+L | Command+L |
Download | Ctrl+D | Command+D |
Delete | Delete | Fn+Backspace |
Delete immediately | Shift+Delete | Shift+Fn+Backspace |
New folder | Ctrl+N | Command+N |
Rename | Ctrl+E | Command+E |
Refresh view | Ctrl+G | Command+G |
The qFlipper application has 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.
To update your Flipper Zero via the qFlipper application, do the following:
Connect your Flipper Zero to your computer via a USB cable.
On your computer, run the qFlipper application.
In the qFlipper application, go to the Advanced controls tab.
Click Update Channel and select a firmware version from the drop-down list (Release is recommended).
Click Update to start the update process.
You can also control your Flipper Zero remotely via the qFlipper application by doing the following:
In the Device information tab, click the Flipper Zero image.
Click the buttons on the screen
or
Use your keyboard to control your Flipper Zero remotely. Click ℹ️ to learn more about keyboard controls.
Additionally, you can capture screenshots from your Flipper Zero device and save them directly to your computer by clicking the SAVE SCREENSHOT button.
If an error occurs during the update process, it is important for us that you describe the issue in detail. Since we don’t collect any usage data and statistics from your computer, you’ll have to report the issue yourself on the forum:
On the forum.flipperzero.one website, go to the Firmware update / qFlipper section.
Read topics and check if this issue was already addressed in the previous topics.
If the issue hasn’t been mentioned earlier, create a new topic by clicking the New Topic button.
In the new topic, describe your issue with steps that led to the issue.
Attach qFlipper logs in the .txt format and click the Create Topic button.
To get qFlipper logs for the current session, do the following:
In the qFlipper application, click LOGS.
Click OPEN FULL LOG and save the opened file to your computer in the .txt format.
qFlipper saves logs for 100 last sessions on your computer, ensuring easy access to past issue records. To retrieve the qFlipper logs for the previous session, do the following:
In the qFlipper application, click LOGS.
Right-click the area where the current session logs are shown.
In the opened context menu, click Browse all logs.
In the opened folder, select the log file you need, paying close attention to the timestamp indicated in its name.
Having issues with qFlipper on Windows? Check out the following page:
