qFlipper is a desktop application for updating Flipper Zero firmware and databases, as well as managing files on the microSD card, and repairing corrupted firmware. The qFlipper application is available on Windows, macOS, and Linux.
Installing qFlipper
To install the qFlipper application on your computer, do the following:
1
Download the qFlipper installation file for your operating system.
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
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
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:
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.
The device information tab gives an overview of the main characteristics
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.
The advanced controls tab gives you access to update, erase, and restore functions
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.
You can manage Flipper Zero files in the qFlipper application
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.
<videoautoplaymutedloopplaysinlinestyle="width: 90%;margin: auto !important;"src="https://cdn.flipperzero.one/qflipper_file_manager.mp4"></video>
<divclass="info flipper-callout"><divclass="callout-header"></div>
When uploading, files with the same names will be overwritten without warning.
</div>
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
Updating your Flipper Zero via qFlipper
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.
<divclass="warning flipper-callout"><divclass="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 <ahref="https://docs.flipperzero.one/basics/sd-card"onclick="next.router.push('https://docs.flipperzero.one/basics/sd-card')"><u>MicroSD card setup</u>.
</div>
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
Controlling Flipper Zero via qFlipper
You can also control your Flipper Zero remotely via the qFlipper application by doing the following:
1
In the Device information tab, click the Flipper Zero's image.
2
Click the buttons on the screen
or
Use your keyboard to control your Flipper Zero remotely. Click ℹ️ to learn more about keyboard controls.
Screen stream and control your Flipper Zero remotely
Additionally, you can capture screenshots from your Flipper Zero device and save them directly to your computer by clicking the SAVE SCREENSHOT button.
Reporting qFlipper issues
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 will have to report the issue yourself on the forum:
Read topics and check if this issue was already addressed in the previous topics.
3
If the issue hasn't been mentioned earlier, create a new topic by clicking the New Topic button.
4
In the new topic, describe your issue with steps that led to the issue.
5
Attach qFlipper logs in the txt format and click the Create Topic button.
To get qFlipper logs for the current session, do the following:
1
In the qFlipper application, click LOGS.
2
Click OPEN FULL LOG and save the opened file to your computer in the .txt format.
You can get full qFlipper logs in the application
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:
1
In the qFlipper application, click LOGS.
2
Right-click the area where the current session logs are shown.
3
In the opened context menu, click Browse all logs.
You can get full qFlipper logs even for the previous sessions
4
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:
