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 QML GLSL Shell C
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
3rdparty 3rdparty/StackWalker/StackWalker.cpp - fix typo May 18, 2016
app Fix GammaRay bundle on non case sensitive file systems. Mar 17, 2016
client client/remotemodel.cpp - in newMessage(), check for null node May 20, 2016
cmake split Toolchain-GCC-i686.cmake into specific versions for Linux and OSX May 23, 2016
common Remove obsolete and unused display state enum. May 21, 2016
compat Reduce memory allocation and string conversion. Mar 7, 2016
core tcpserverdevice.cpp - assert in the UnknownNetworkLayerProtocol case May 19, 2016
docs Add self-test option to the command line tool. Apr 8, 2016
inprocessui Handle multiple probes for Qt layout builds. Jan 13, 2016
launcher launcher/injector/gdbinjector.h, lldbinjector.h - explicit ctors May 19, 2016
plugins Fix objects model not knowing all quick items. May 24, 2016
probe Replace windows.h -> qt_windows.h in every Qt source code. Apr 29, 2016
resources Fix GammaRay bundle on non case sensitive file systems. Mar 17, 2016
tests tests/CMakeLists.txt - don't run translatortest if there are no trans… May 2, 2016
ui Add multiline text editor. May 24, 2016
.emacs-dirvars For us XEmacs people Sep 22, 2011
.gitignore Minor: These files come from kdiff3 Oct 29, 2013
.kateconfig Prefer Qt coding style for new code. May 15, 2016
.krazy .krazy - set the params for coding style checking, if we ever want that May 16, 2016
CHANGES CHANGES - update for 2.4.1 Mar 11, 2016
CMakeLists.txt CMakeLists.txt - add -Wswitch to CXXFLAGS for gcc and clang May 19, 2016
GammaRay.appdata.xml GammaRay.appdata.xml - add new kudos section Nov 30, 2015
GammaRay.desktop GammaRay.desktop - add keywords Jan 8, 2016
GammaRayConfig.cmake.in Fix the install location fallback handling for external plugins. Jan 11, 2015
Install.txt Remove obsolete remains of the GraphViz dependency. Mar 9, 2016
LICENSE.GPL.txt update copyright year 2016 Jan 2, 2016
LICENSE.US.txt Update ReadMe's and License files for GPL and commercial variants. May 11, 2015
LICENSE.txt update copyright year Jan 3, 2016
ReadMe-commercial.txt ReadMe's - support@kdab email is going away -- use info@kdab instead. Apr 12, 2016
ReadMe.md Readme.md - make it a symlink to Readme.txt again May 11, 2015
ReadMe.txt ReadMe's - support@kdab email is going away -- use info@kdab instead. Apr 12, 2016
add_license_blurb.sh add_license_blurb.sh - update for commerical license Jun 11, 2015
config-gammaray-version.h.cmake second half of rename commit - sorry for the early push :( Sep 22, 2011
config-gammaray.h.cmake Fix selection synchronization on server-side sorting/filtering. Mar 30, 2016
debian.changelog prep for 2.4.1 release Mar 11, 2016
debian.control packaging file fixes Dec 20, 2015
debian.rules merge from 1.2 branch Jun 28, 2012
gammaray-qt4-debian.control gammaray-qt4-debian.control - the debian.control for gammaray-qt4 pkgs May 12, 2016
gammaray-qt4.dsc prep for 2.4.1 release Mar 11, 2016
gammaray-qt4.spec prep for 2.4.1 release Mar 11, 2016
gammaray.dsc prep for 2.4.1 release Mar 11, 2016
gammaray.spec prep for 2.4.1 release Mar 11, 2016

ReadMe.md

Logo

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

Contact

Get Involved

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

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

License

The GammaRay Software is (C) 2010-2016 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 http://www.kdab.com/contact. 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.

GammaRay and the GammaRay logo are trademarks of Klarälvdalens Datakonsult AB.

Something went wrong with that request. Please try again.