Getting GammaRay

Allen Winter edited this page Aug 2, 2018 · 37 revisions

Getting GammaRay

Download Pre-Compiled Packages

Since GammaRay needs to be compiled for exactly the Qt version you are using in the application you are debugging (and on most platforms even with the same compiler and compiler settings), the pre-compiled packages are only useable in combination with the corresponding Qt. For Linux packages that is usually the standard Qt packages of that distribution.

Example install script for Ubuntu-18.04 (and Linux Mint Tara)

echo "deb $repo/ /" | sudo tee -a /etc/apt/sources.list.d/obs.list
wget -O - $repo/Release.key | sudo apt-key add -
sudo apt install gammaray

Build Recipes for Source-Based Distributions

There are ready made build recipes for a number of source-based distributions, those are usually easier to use than building GammaRay manually.

Building From Source

Requirements for compiling and using it:

  • Qt (obviously)
    • Supported: 4.8, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 5.10, 5.11
    • Previously supported (likely to work with older GammaRay versions, or some extra #ifdefs): 5.0, 5.1, 5.2
    • Make sure to have private Qt headers installed. That is automatically the case when using the Qt SDK or a self-compiled Qt, but some Linux distributions ship them in separate packages (e.g. qtX5-private-dev on Ubuntu).
  • CMake >= 3.0, CMake 3.1.0 (for MSVC)
  • GCC >= 4.8 or MSVC >= 2010 or Clang >= 3.1, ie. a compiler supporting some basic C++11 features.

The following libraries enable additional features when found on your system at compile time:

  • librt (Linux only), enables the timer profiler
  • KDSME for runtime QStateMachine visualization

The following libraries enable some rarely needed esoteric features when found at compile time:

  • KDE4 or KF5 KCoreAddons, enables the KJob tracker plug-in
  • KF5SyntaxHighlighting, enables syntax highlighting in the code editor

The following runtime dependencies are recommended:

  • gdb or lldb, enables runtime attaching to already running targets (Linux/Mac only)

For using GammaRay on an embedded device, also see Cross-compiling GammaRay.


Easiest way to get the source is cloning the Git repository:

git clone git://

A ZIP download is also available:

Once you have the source code, follow the build instructions in Install.txt.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.