Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
GammaRay is a tool to poke around in a Qt-application and also to manipulate the application to some extent.
C++ CMake QML Other
Failed to load latest commit information.
3rdparty Do not query the row count repeatedly.
app Don't automatically quit when being disconnected.
client Use QPointer for main window as external users might delete it.
cmake Generate .pri files to enable qmake usage.
common Only allow to add new dynamic properties on QObjects.
core This is supposed to be a const reference.
docs Mainpage.dox - update the license section
hooking krazy excludeall some checks due to the low-level nature of this code
inprocessui update copyright year
launcher Delete breakpoints before continuing in unit test mode.
plugins Adapt to KDSME API change: ConfigurationController -> RuntimeController
resources CMakeLists.txt: Allow configuration of DATAROOTDIR
tests Enable QT_ASSERT here in release builds as well.
ui Only allow to add new dynamic properties on QObjects.
.emacs-dirvars For us XEmacs people
.gitignore Minor: These files come from kdiff3
.kateconfig Add .kateconfig file with indention settings.
.krazy skip cmake/ECMGeneratePri.cmake, a 3rdparty contribution
CHANGES Merge remote-tracking branch 'github/2.2'
CMakeLists.txt CMakeLists.txt - don't install our .pri files in our own share subdir.
GammaRay.appdata.xml isseu82: fix typo causing "the builder to skip the application appdat…
GammaRay.desktop Correctly install icons, so that the right size is picked automatically.
GammaRayConfig.cmake.in Fix the install location fallback handling for external plugins.
Install.txt Update build requirements.
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.
ReadMe.md Readme.md - make it a symlink to Readme.txt again
ReadMe.txt Update ReadMe's and License files for GPL and commercial variants.
add_license_blurb.sh Don't hardcode my name/email for the CMakeLists.txt license either.
config-gammaray-version.h.cmake second half of rename commit - sorry for the early push :(
config-gammaray.h.cmake Give the probe DLL a "lib" prefix on Android.
debian.changelog prepare for 2.2.1 release.
debian.control merge from 1.2 branch
debian.rules merge from 1.2 branch
gammaray.dsc prepare for 2.2.1 release.
gammaray.spec gammaray.spec - fix unresolvable on modern fedoras

ReadMe.md

Introduction

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 to some extent, edit QObject static and dynamic properties.

  • View and call slots of a QObject.

  • View other QObject elements such as signals, enums and class infos.

  • List all QObject inbound and outbound signal/slot connections.

  • Provide a layout information overlay for QWidget applications.

  • Inspect all QPainter operations used to draw a specific widget.

  • Browse the QtQuick2 item tree and scenegraph.

  • Plot object lifetime and emitted signals.

  • View the content of any QAbstractItemModel. Very useful when debugging a proxy model chain for example.

  • Browse the QAbstractProxyModel hierarchy.

  • 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.

  • 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.

  • Browse QStateMachines, along with their states and transitions.

  • Show all registered meta types.

  • Show all installed fonts.

  • Show all available codecs.

  • Browse all QTextDocuments, along with the ability to edit them and view their internal structures.

  • Show all QTimers and their statistics (number of wakeups, wakeup time, ...)

Contact

Get Involved

If you want to contribute, please check out: https://github.com/KDAB/GammaRay/wiki/Get-Involved

Contributing

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

License

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.

Please visit http://www.kdab.com to meet the people who write code like this.

Something went wrong with that request. Please try again.