Installing Qt for desktop

Qt is a cross-platform application framework used by Pegasus. At least Qt 5.9 is required, with 5.12 or later recommended for better performance on embedded platforms. For desktop platforms you can get the Qt tools using their installer:

Then walk through the installation, and select the component "Desktop gcc" (on Linux), "MinGW" (on Windows) or "macOS" (on macOS):

Now you have the Qt libraries and the Qt Creator IDE installed.

Components on Windows

On Windows you can choose between MinGW and MSVC compiler packages. If you're planning to use Visual Studio and edit the source code, you can select the matching MSVC component instead of MinGW.


These instructions are for desktop platforms. For embedded devices, you have to compile Qt manually, or use the prebuilt libraries available on Pegasus' GitHub page. See the cross compiling Qt page for more information.

Alternative installations


On many Linux distros, the Qt libraries in the official repositories are often several years old (as a trade-off between stability and access to the latest software), or miss some components.

Ubuntu, Debian

Debian 10 (buster) and Ubuntu 19.04 or later contains up-to-date Qt releases, so building Pegasus should be possible using the following packages:

Earlier releases contain an up-to-date Qt release, but miss a few necessary packages. You can either use the Qt installer (see above), or use the following PPA:

sudo add-apt-repository ppa:beineri/opt-qt-5.11.1-bionic

sudo apt-get update
sudo apt-get install  \
    qt59declarative  \
    qt59graphicaleffects  \
    qt59gamepad  \
    qt59imageformats  \
    qt59multimedia  \
    qt59svg  \

source /opt/qt511/bin/

To use this installation, you will need to call /opt/qt511/bin/ (or /opt/qt59/bin/ on 14.x/16.x) every time you open a new terminal. You can do this by adding the source ... line above to your ~/.bashrc file (or whatever shell you use).

16.04 and 14.04

On older Ubuntu releases, you can use ppa:beineri/opt-qt596-xenial and ppa:beineri/opt-qt596-trusty.


If you're using Arch, you can get Qt from AUR; here's the relevant wiki page.



Qt is available in the MSYS2 repos. See


At the time of writing, Qt 5.9 is available in vcpkg as a port.



Qt is available in the Homebrew repos, but may not be up to date. See