Skip to content
This repository
Fetching contributors…


Cannot retrieve contributors at this time

file 107 lines (68 sloc) 2.914 kb


GammaRay - Qt-application inspection and manipulation tool.


gammaray [--injector <injector>] [--pid <pid> | <application> <args>]


GammaRay inspects runtime internals of a Qt-application, such as: Object tree, properties, signal/slots, widgets, models, graphics views, javascript debugger, resources, state machines, meta types, fonts, codecs, text documents

When run without any options, gammaray will present a list of running Qt-applications from which you can attach the selected injector. Else, you can attach to a running process by specifying its pid, or you can start a new Qt-application by specifying its name (and optional arguments).



Print help message and exit.


Print version information and exit.

-p, --pid <pid>

Attach to running Qt application with the specified pid.

-i, --injector <injector>

Set the specified injection type.

Supported injectors are: preload (Linux, Mac OS) gdb (Linux. requires gdb to be installed) style windll (Windows)


Run gammaray on the Qt-application qtfoo with command line arguments 'arg1' and 'arg2':
 % gammaray /path/to/qtfoo arg1 arg2
Invoke gammaray on the Qt-application running with pid 1234:
 % gammaray --pid 1234
Invoke gammaray on with injector gdb on Qt-application running with pid 1234:
 % gammaray --injector gdb --pid 1234


Exits with 0 under normal operation; otherwise, exists with a positive integer indicating a problem occurred while launching or attaching an injector.


Copyright (C) 2010-2012 Klaralvdalens Datakonsult AB, a KDAB Group company, <>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.


 Volker Krause <> (Head Engineer)
 Allen Winter <>
 Andreas Holzammer <>
 David Faure <>
 Kevin Funk <>
 Milian Wolff <>
 Patrick Spendrin <>
 Stephen Kelly <>
 Till Adam <>
 Tobias Koenig <>
Something went wrong with that request. Please try again.