Skip to content
An easy-to-use environment to cross-compile Qt applications for Raspberry Pi from your desktop.
Branch: master
Clone or download
GuillaumeLazar Merge pull request #89 from jczacharia/master
Unmount loop0 before use
Added qtgraphicaleffects
Latest commit 60ec6d1 Sep 20, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
ansible Add apt dependencies and qtrpi installation youtube link Apr 6, 2017
utils Unmount loop0 before use Sep 15, 2018
.gitignore Add synchronize cache script Mar 27, 2017
CHANGELOG Update May 9, 2018
Vagrantfile Check global env variables at beginning of init scripts Apr 21, 2017 Check global env variables at beginning of init scripts Apr 21, 2017



Offer an easy-to-use environment to cross-compile Qt application on a Raspberry Pi. This repo contains all the scripts needed to prepare a sysroot, cross-compile Qt and deploy Qt libraries to your Raspberry.

For more information, go to the wiki

Difference between init-qtrpi-minimal and init-qtrpi-full

  • init-qtrpi-minimal, the typical way: downloads ready-to-use Qt binaries for the Raspberry Pi and a minimal sysroot that we released on the download page
  • init-qtrpi-full, the custom way: compiles on your computer the Qt binaries for the Raspberry Pi to let you tweak the configuration, enhance the compilation by adding some missing Qt modules to QtRpi or add some specific third-party dependencies


init-qtrpi-minimal init-qtrpi-full
Raspbian image from
Toochain from the github project from the github project
Sysroot from qtrpi team generated from raspbian image
Qt binaries from qtrpi team compiled

Tutorial of

This tutorial will help you to:

  • Configure your host computer to be able to cross-compile Qt 5.7.0 applications for your Raspberry Pi 3
  • Deploy the pre-compiled Qt binaries on your Raspberry Pi
  • Cross-compile your application for a Raspberry Pi with the CLI or Qt Creator


  • A 64-bit Linux host computer
  • A Raspberry Pi 3 with Raspbian Jessie (Raspbian Stretch is currently not supported!)

In this example, you already have an SSH access to your Raspberry Pi 3 at with the user pi. The script will use sudo several times to install the packages on the board. You should add your SSH key in your Raspberry Pi. For example with ssh-copy-id:

ssh-copy-id pi@


First, install the dependencies:

sudo apt-get install curl g++ gdb-multiarch git realpath unzip zip

Open a terminal and follow the steps below:

git clone
cd qtrpi
export QTRPI_QT_VERSION='5.7.0'
export QTRPI_TARGET_DEVICE='linux-rpi3-g++'
export QTRPI_TARGET_HOST='pi@'
./ --prepare-rpi

Note: You can also export the environment variables in your .bashrc.

Usage in CLI

cd myproject

You can now copy and execute the generated binary file on your Raspberry Pi

Note: You can also add /opt/qtrpi/bin/ to your PATH in your .bashrc and call qmake-qtrpi without the full path.

Usage in Qt Creator

How to build a Raspberry Pi 3 application from your desktop Qt Creator (step by step video): Cross-compile Qt applications for your Raspberry Pi 3 - 2. Configure Qt Creator

Tutorial of

How to add a new Qt module in QtRpi?

You can’t perform that action at this time.