QGroundControl Ground Control Station
C++ C QML HTML Java QMake Other
Latest commit 8f8d79f Aug 26, 2016 @DonLakeFlyer DonLakeFlyer committed on GitHub Merge pull request #3979 from DonLakeFlyer/LogDownloadTest
Initial implementation of LogDownloadTest
Failed to load latest commit information.
android Merge remote-tracking branch 'upstream/Stable_V3.0' Jul 30, 2016
debian minor deb package cleanup May 22, 2016
deploy Remove license page Jul 28, 2016
doc Doxygen qml support Aug 2, 2016
ios Restrict map providers for iOS. Aug 1, 2016
libs Updated MAVLink 2.0 headers Aug 20, 2016
resources Update OpenGL buglist to blacklist rotation on Intel HD graphics adap… Jun 12, 2016
src Remove bad header Aug 25, 2016
test Correctly handle large numbers of waypoints Feb 12, 2016
tools android tagged builds exceed master versionCode Jul 27, 2016
.ackrc add .ackrc to ignore doc directory Apr 12, 2016
.appveyor.yml Full install of gstreamer Aug 12, 2016
.gitignore Initial App Store build settings. Jun 3, 2016
.gitmodules Update MAVLink git modules Jun 24, 2016
.travis.yml travis-ci android deploy releases to beta track Jul 27, 2016
.vagrantconfig.yml Vagrant fixes (#3598) Jun 21, 2016
.ycm_extra_conf.py Vim YouCompleteMe config Dec 26, 2014
CONTRIBUTING.md Add contributing file with instructions for contributors. Feb 12, 2016
COPYING.md All authors with active code on master have agreed to add Apache 2.0 … May 31, 2016
CodingStyle.cc Update more license terms May 31, 2016
CodingStyle.h Update more license terms May 31, 2016
CodingStyle.qml Update more license terms May 31, 2016
Custom-Info.plist Correct version info for all OSX/iOS builds Mar 6, 2016
QGCCommon.pri Restrict map providers for iOS. Aug 1, 2016
QGCExternalLibs.pri Remove 3D Mouse Support Feb 17, 2016
QGCInstaller.pri Fix app naming Jul 28, 2016
QGCSetup.pri Deploy OpenSSL Jul 19, 2016
README.md add latest version to README (#3718) Jul 1, 2016
UnitTest.qrc Major rewrite of Mission Item json editor support Aug 18, 2016
Vagrantfile Vagrant fixes (#3598) Jun 21, 2016
android_environment.sh fix qgroundcontrol to QGroundControl rename Jul 9, 2016
build_ios.sh Fixes to iOS App Store build. Jul 27, 2016
installheader.bmp Update NSIS installer to modern UI Feb 5, 2016
license.txt Added Windows icon and NSIS script from Hendrik May 8, 2010
qgcresources.qrc Tweaking Motor Component. Jul 20, 2016
qgroundcontrol.pro Initial implementation of LogDownloadTest Aug 25, 2016
qgroundcontrol.qrc Major rewrite of Mission Item json editor support Aug 18, 2016


QGroundControl Ground Control Station

Open Source Micro Air Vehicle Ground Control Station

Releases Travis Build Status Appveyor Build Status


The license terms are set in the COPYING.md file.

Obtaining source code

Source code for QGroundControl is kept on GitHub: https://github.com/mavlink/qgroundcontrol.

git clone --recursive https://github.com/mavlink/qgroundcontrol.git

Each time you pull new source to your repository you should run git submodule update to get the latest submodules as well. Since QGroundControl uses submodules, using the zip file for source download will not work. You must use git.

Supported Builds

Native Builds

QGroundControl builds are supported for OSX, Linux, Windows, iOS and Android. QGroundControl uses Qt as its cross-platform support library and uses QtCreator as its default build environment.

  • OSX: OSX 10.7 or higher, 64 bit, clang compiler
  • Ubuntu: 64 bit, gcc compiler
  • Windows: Vista or higher, 32 bit, Visual Studio 2013 compiler
  • iOS: 8.0 and higher
  • Android: Jelly Bean (4.1) and higher
  • Qt version: 5.5.1 ONLY
Install QT

You need to install Qt as described below instead of using pre-built packages from say, a Linux distribution because QGroundControl needs access to private Qt headers.

  • Download the Qt installer
    • Make sure to install Qt version 5.5.1 NOT 5.4.x, 5.6.x, 5.7.x, etc.
    • Ubuntu: Set the downloaded file to executable using:chmod +x. Install to default location for use with ./qgroundcontrol-start.sh. If you install Qt to a non-default location you will need to modify qgroundcontrol-start.sh in order to run downloaded builds.
    • Windows: Default installer not quite correct, use this instead
Install additional packages:
  • Ubuntu: sudo apt-get install espeak libespeak-dev libudev-dev libsdl1.2-dev
  • Fedora: sudo dnf install espeak espeak-devel SDL-devel SDL-static systemd-devel
  • Arch Linux: pacman -Sy espeak
  • Windows: USB Driver to connect to Pixhawk/PX4Flow/3DR Radio
  • Android: Qt Android Setup
Building using Qt Creator
  • Launch Qt Creator and open the qgroundcontrol.pro project.
  • Select the appropriate kit for your needs:
    • OSX: Desktop Qt 5.5.1 clang 64 bit
    • Ubuntu: Desktop Qt 5.5.1 GCC bit
    • Windows: Desktop Qt 5.5.1 MSVC2013 32bit
    • Android: Android for armeabi-v7a (GCC 4.9, Qt 5.5.1)
  • Note: iOS builds must be built using xCode: http://doc.qt.io/qt-5/ios-support.html. Use Qt Creator to generate the XCode project (Run Qmake from the context menu).


A Vagrantfile is provided to build QGroundControl using the Vagrant system. This will produce a native Linux build which can be run in the Vagrant Virtual Machine or on the host machine if it is compatible.

  • Download Vagrant
  • Install Vagrant
  • From the root directory of the QGroundControl repository run "vagrant up"

Additional build notes for all supported OS

  • Warnings as Errors: Specifying CONFIG+=WarningsAsErrorsOn will turn all warnings into errors which breaks the build. If you are working on a pull request you plan to submit to github for consideration, you should always run with this setting turned on, since it is required for all pull requests. NOTE: Putting this line into a file called "user_config.pri" in the top-level directory (same directory as qgroundcontrol.pro) will set this flag on all builds without interfering with the GIT history.
  • Parallel builds: For non Windows builds, you can use the '-j#' option to run parellel builds.
  • Location of built files: Individual build file results can be found in the build_debug or build_release directories. The built executable can be found in the debug or release directory.
  • If you get this error when running qgroundcontrol: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version 'GLIBCXX_3.4.20' not found. You need to either update to the latest gcc, or install the latest libstdc++.6 using: sudo apt-get install libstdc++6.

Additional functionality

QGroundcontrol has functionality that is dependent on the operating system and libraries installed by the user. The following sections describe these features, their dependencies, and how to disable/alter them during the build process. These features can be forcibly enabled/disabled by specifying additional values to qmake.

Opal-RT's RT-LAB simulator

Integration with Opal-RT's RT-LAB simulator can be enabled on Windows by installing RT-LAB 7.2.4. This allows vehicles to be simulated in RT-LAB and communicate directly with QGC on the same computer as if the UAS was actually deployed. This support is enabled by default once the requisite RT-LAB software is installed. Disabling this can be done by adding DEFINES+=DISABLE_RTLAB to qmake.

XBee support

QGroundControl can talk to XBee wireless devices using their proprietary protocol directly on Windows and Linux platforms. This support is not necessary if you're not using XBee devices or aren't using their proprietary protocol. On Windows, the necessary dependencies are included in this repository and no additional steps are required. For Linux, change to the libs/thirdParty/libxbee folder and run make;sudo make install to install libxbee on your system (uninstalling can be done with a sudo make uninstall). qmake will automatically detect the library on Linux, so no other work is necessary.

To disable XBee support you may add DEFINES+=DISABLE_XBEE to qmake.

Video Streaming

Check the Video Streaming directory for further instructions.