flipperdevices / qFlipper

qFlipper — desktop application for updating Flipper Zero firmware via PC
https://update.flipperzero.one
GNU General Public License v3.0
1.16k stars 155 forks source link

qFlipper

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.

qFlipper

Download

Download official qFlipper builds here: update.flipperzero.one

download qFlipper Button

Features

Build from sources

Cloning

Make sure to clone the project together with submodules:

git clone https://github.com/flipperdevices/qFlipper.git --recursive

Windows

Build requirements:

Edit build_windows.bat to adjust to your build environment and then run:

build_windows.bat

Note: STM32 Bootloader driver is not provided in this repository.

Linux

Docker build (AppImage, official)

Setup dev container by running:

docker compose up -d

Compile qFlipper by running:

docker compose exec dev ./build_linux.sh

Standalone build

Build requirements:

Make sure to install the following Qt modules (the exact package names might differ slightly depending on your Linux distribution):

base, tools, serialport, declarative,  wayland, [quickcontrols2, graphicaleffects] (Qt5 only), qt5-compat (Qt6 only)

Then run:

mkdir build && cd build
qmake ../qFlipper.pro PREFIX=/path/to/install/dir -spec linux-g++ CONFIG+=qtquickcompiler && 
make qmake_all && make && make install

Caution: 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.

MacOS

Build requirements:

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

Run

Linux

./build/qFlipper-x86_64.AppImage

or 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:

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

Package managers support

See contrib for available options.

Project structure

Reporting bugs

qFlipper is a project under active development. Please report any encountered bugs to make it better!

The (mostly) complete guide is located here.

Known bugs