This is the repository for binary images associated with the Raspberry Qt project. You can generate these binary images yourself by using the instructions from Gitorious (see left). These images are based on the instructions from the Qt Raspberry Pi Beginner's Guide.

Binary Packages




  1. Download and extract the above package into a folder in your home directory (or /opt for multiple users)
  2. Follow the below instructions

Flashing Raspberry Pi SD card

WARNING: You can wipe your hard drive and lose all your data if you aren't careful. These images are offered as-is.

  1. Insert an SD card
  2. Determine what /dev node the SD card is using:
    sudo fdisk -l
  3. Copy the image to the card:
    dd bs=1M if=<path-to-img> of=<path-to-device>
  4. Ensure all writing has been finalized:
  5. Eject the card and insert it into the Raspberry Pi
  6. Boot the Raspberry Pi

Configuring Qt Creator

  1. Go to the "Build & Run" options
    • Go to Tools -> Options
    • Click "Build & Run"
  2. Add the Raspberry Pi cross-compiler
    • Select the "Compilers" tab and click "Add" -> "GCC"
    • Set "Compiler path" to "/home/<username>/opt/gcc-4.7-linaro-rpi-gnueabihf/bin/arm-linux-gnueabihf-g++"
    • Set "Name" to "GCC RPI"
  3. Add the Raspberry Pi Qt version
    • Select "Qt Versions"
    • Click "Add..." and select "/usr/local/qt5pi/bin/qmake"
  4. Go to the "Devices" options
    • Click "Devices"
  5. Add the Raspberry Pi
    • Click "Add..."
    • Select "Generic Linux Device" and click "Start Wizard"
    • Enter a name for the device
    • Enter the IP address for the device
    • Enter "pi" for the username
    • Enter "raspberry" for the password
  6. Go back to "Build & Run"
    • Click "Build & Run"
  7. Add the Raspberry Pi kit
    • Click "Add" button
    • Enter "Raspberry Pi" for name
    • Select "Generic Linux Device for device
    • Enter "/mnt/rasp-pi-rootfs" for sysroot
    • Select "GCC RPI" for compiler
    • Browse to ~/opt/gcc-4.7/linaro-rpi-gnueabihf/bin/arm-linux-gnueabihf-gdb for debugger
    • Select qt5pi for Qt Version
  8. Click OK

Building an Example Project

  1. Create a new project
    • Select "File" -> "New File or Project"
    • Select "Qt Console Application" and click "Choose..."
    • Call your project "pip" and place it in "~/opt", then click "Next"
    • Ensure "Raspberry Pi" is checked and uncheck any other kits, then click "Next"
    • Click "Finish"
  2. Add a new resource file called "main.qrc" in the main directory of the project
  3. Add a new QML file called "main.qml" in the main directory of the project
  4. Add the QML file to main.qrc
    • Double-click main.qrc
    • Click "Add"->"Add Prefix"
    • Change the prefix to "/"
    • Click "Add"->"Add files" and select "main.qml"
  5. Modify main.cpp to show the QML
    • Double-click main.cpp
    • Change the contents to the following:
    #include <QGuiApplication>
    #include <QtQml>
    #include <QQuickView>
    int main(int argc, char *argv[])
    	QGuiApplication a(argc, argv);
    	QQuickView v;
    	return a.exec();
  6. Modify main.qml to make it more interesting
    • Double-click "main.qml"
    • Change the contents to the following:
    import QtQuick 2.0
    	color: "green"
  7. Modify to deploy all files to the Pi's home directory correctly:
    • Double-click ""
    • Change the contents to the following:
    QT       += core gui qml quick
    TARGET = pip
    CONFIG   += console
    CONFIG   -= app_bundle
    TEMPLATE = app
    target.path = /home/pi
    INSTALLS += target
    SOURCES += main.cpp
    RESOURCES += main.qrc
    OTHER_FILES += main.qml
  8. Deploy the project to the Pi
    • Press F5
    • The Pi's screen should turn green
    • Press the red "STOP" button
    • The Pi's screen should return to normal
    • Press Ctrl-2 to return to Edit mode
  9. Congratulations!


See the Gitorious project for active contributors.