Skip to content
GammaRay is a tool to poke around in a Qt-application and also to manipulate the application to some extent.
C++ CMake C QML Shell Emacs Lisp
Latest commit 9259b7d @akreuzkamp akreuzkamp Merge pull request #161 from KDAB/feature/fixArgumentDestructor
Fix wrong destruction of MethodArgument.
Failed to load latest commit information.
3rdparty Don't compile the KF5ItemModel classes we use into GammaRay libraries.
app Make the injector API asynchronous, and allow to abort the launcher.
client No more implicit URL casts.
cmake Disable clipboard support for QNX.
common Merge pull request #161 from KDAB/feature/fixArgumentDestructor
compat Support for injecting Qt5 compat macros in Qt4 builds.
core Rework the demangling code to void an extra QByteArray allocation.
docs Also mention the commercial license option in the man page.
inprocessui Add another batch of commercial license headers.
launcher Attempt to fix the Windows build.
plugins Don't compile the KF5ItemModel classes we use into GammaRay libraries.
probe Rename so folder name and its contained target actually match.
resources CMakeLists.txt: Allow configuration of DATAROOTDIR
tests Make this work with Qt4, where objectName() has no change notification.
ui Don't compile the KF5ItemModel classes we use into GammaRay libraries.
.emacs-dirvars For us XEmacs people
.gitignore Minor: These files come from kdiff3
.kateconfig Add .kateconfig file with indention settings.
.krazy .krazy - skip ECMQueryQmake.cmake
CHANGES preparing for 2.3.0 release
CMakeLists.txt Also check for __cxa_demangle rather than guessing its availability.
GammaRay.appdata.xml GammaRay.appdata.xml - add new kudos section
GammaRay.desktop Correctly install icons, so that the right size is picked automatically. Fix the install location fallback handling for external plugins.
Install.txt Add Android build & usage instructions.
LICENSE.GPL.txt Update ReadMe's and License files for GPL and commercial variants.
LICENSE.US.txt Update ReadMe's and License files for GPL and commercial variants.
LICENSE.txt Update ReadMe's and License files for GPL and commercial variants.
ReadMe-commercial.txt Update ReadMe's and License files for GPL and commercial variants. - make it a symlink to Readme.txt again
ReadMe.txt Attempt to improve the formatting on the Github main page. - update for commerical license
config-gammaray-version.h.cmake second half of rename commit - sorry for the early push :(
config-gammaray.h.cmake Also check for __cxa_demangle rather than guessing its availability.
debian.changelog preparing for 2.3.0 release
debian.control new spec files for gammaray-qt4 package on OBS
debian.rules merge from 1.2 branch
gammaray+sme+kde-qt5.spec gammaray+sme+kde-qt5.spec - RPM spec file for Qt5 based, along with SME
gammaray-qt4.dsc new spec files for gammaray-qt4 package on OBS
gammaray-qt4.spec new spec files for gammaray-qt4 package on OBS
gammaray.dsc improved specs for OBS
gammaray.spec improved specs for OBS


GammaRay is a software introspection tool for Qt applications developed by KDAB. Leveraging the QObject introspection mechanism it allows you to observe and manipulate your application at runtime. This works both locally on your workstation and remotely on an embedded target.

Augmenting your instruction-level debugger, GammaRay allows you to work on a much higher level, with the same concepts as the frameworks you use. This is especially useful for the more complex Qt frameworks such as model/view, state machines or scene graphs.

Among other things GammaRay can:

  • Browse the QObject tree with live updates.
  • View and edit object properties.
  • View and invoke slots of a QObject, and monitor its signals.
  • List all QObject inbound and outbound signal/slot connections.
  • Provide a layout information overlay for QWidget and QtQuick2 applications.
  • Inspect all QPainter operations used to draw a specific widget.
  • Browse the QtQuick2 item tree and scenegraph.
  • Inspect shaders and geometry data of QtQuick2 items.
  • Plot object lifetime and emitted signals.
  • Browse the QAbstractProxyModel hierarchy and inspect intermediate results in a proxy model chain.
  • Visual live inspection of QStateMachines.
  • Browse the item tree of any QGraphicsView scene.
  • Show a live preview of QGraphicsView items, including showing their coordinate system, transformation origin, rotate/zoom/pan, etc.
  • Intercept translations and change them at runtime.
  • Inspect all building blocks of a QStyle.
  • Show all QTimers and their statistics (number of wakeups, wakeup time, ...)
  • Browse all QTextDocuments, along with the ability to edit them and view their internal structures.
  • Act as a complete java script debugger, attachable to any QScriptEngine (including the usually not accessible one used by QtQuick1 internally).
  • Perform HTML/CSS/DOM/JS introspection/editing/profiling on any QWebPage, thanks to QWebInspector.
  • Browse the QResource tree and its content.
  • Show all registered meta types.
  • Show all installed fonts.
  • Show all available codecs.


Get Involved

If you want to contribute, please check out:

KDAB will happily accept external contributions, but substantial contributions will require a signed Copyright Assignment Agreement. Contact for more information.


The GammaRay Software is (C) 2010-2015 Klarälvdalens Datakonsult AB (KDAB), and is available under the terms of the GPL version 2 (or any later version, at your option). See LICENSE.GPL.txt for license details.

Commercial use is also permitted as described in ReadMe-commercial.txt.

About KDAB

GammaRay is supported and maintained by Klarälvdalens Datakonsult AB (KDAB).

KDAB, the Qt experts, provide consulting and mentoring for developing Qt applications from scratch and in porting from all popular and legacy frameworks to Qt. We continue to help develop parts of Qt and are one of the major contributors to the Qt Project. We can give advanced or standard trainings anywhere around the globe.

If you would like to have a custom plugin for GammaRay to visualize, profile or debug your own specific components or applications, get in touch with us via KDAB engineers have a lot of experience writing GammaRay plugins and can be contracted to help you get yours working and improve your development efficiency.

Something went wrong with that request. Please try again.