Graphical desktop application for updating Flipper Zero firmware via PC
qFlipper is completely open source and based on Qt framework. Runs on Windows, macOS, Linux.
Download official qFlipper builds here: update.flipperzero.one
- Update Flipper's firmware and supplemental data with a press of one button
- Repair a broken fimware installation
- Stream Flipper's display and control it remotely
- Install firmware from a
.dfufile - Backup and restore settings, progress and pairing data
- Automatic self-update feature
- Command line interface
Build requirements:
- MS Visual Studio 2019 or newer
- Qt (MSVC build) >= 5.15.0
- Windows Driver Kit (to build libwdi)
- NSIS (to generate the installer)
Edit build_windows.bat to adjust to your build environment and then run:
build_windows.batdocker-compose exec dev ./build_linux.shBuild requirements:
- Qt >= 5.15.0
- libusb >= 1.0.16
mkdir build && cd build
qmake ../qFlipper.pro PREFIX=/path/to/install/dir -spec linux-g++ CONFIG+=qtquickcompiler &&
make qmake_all && make && make installCaution: make installing to the system prefix is not recommended. Instead, use this method for building distro-specific packages.
In this case, it is possible to disable the built-in application update feature by passing DEFINES+=DISABLE_APPLICATION_UPDATES to the qmake call.
Build requirements:
- Xcode or command line tools
- Qt >= 5.15.0
- libusb
If you want to sign binaries, set SIGNING_KEY environment variable:
export SIGNING_KEY="Your Developer Key ID"
Building, signing and creating package:
./build_mac.sh
Resulting image can be found in: build_mac/qFlipper.dmg
./build/qFlipper-x86_64.AppImageor just launch the file above from your favourite file manager. You will likely need to set up udev rules in order to use qFlipper as a normal user. It can be done automatically by running this script:
chmod +x setup_rules.sh
./setup_rules.shSee contrib for available options.
application- The main graphical application, written mostly in QML.backend- The backend library, written in C++. Takes care of most of the logic.dfu- Low level library for accessing USB and DFU devices.tool- The command line interface, provides nearly all main application's functionality.plugins- Protobuf-based communication protocol support.3rdparty- Third-party libraries.contrib- Contributed packages and scripts.driver-tool- DFU driver installation tool for Windows (based onlibwdi).docker- Docker configuration files.installer-assets- Supplementary data for deployment.
qFlipper is a project under active development. Please report any encountered bugs to make it better!
The (mostly) complete guide is located here.
- Sometimes Flipper's serial port doesn't get recognised by the OS, which leads to firmware update errors. This is a firmware issue.
- On some systems, there is noticeable flicker during opening, closing or resizing of the log area