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.
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:
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
The qFlipper application is compatible with macOS version 10.14 or later. The application is optimized forM1Apple SiliconMacs.
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+xfilename.AppImage.
4
Run the AppImage:./filename.AppImage.
Set up udev rules
After making the application executable via the GUI or Terminal, you'll 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]
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.
<video autoplay muted loop playsinline style="width: 90%; margin: auto !important;" src="https://cdn.flipperzero.one/qflipper_file_manager.mp4"></video>
<div class="info flipper-callout"> <div class="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 |
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.
<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>
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
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 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.
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:
1
On the forum.flipperzero.one website, go to the Firmware update / qFlipper section.
2
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:
Troubleshooting drivers on Windows
 - Doctor Of Credit)