<-- Back to Andy Balaam Home


Home | Download | Configuration | Development | Contact | License

CCGtk is a CruiseControl system tray icon for Linux that attempts to inform you (as unobtrusively as possible) only when something interesting has happened.

The tray icon appears red when some builds are failing, and green when all are passing.

When a build's state changes, a notification bubble pops up telling you which builds changed.

Click the icon to jump to the CruiseControl dashboard. From there you can follow the links to see why a build failed.


You can download a package for your Linux distribution, or a tarball, from the Sourceforge download page.

Ubuntu and other Debian-derived distribution users should choose the ".deb" file. Download it and double-click it to install.

Fedora and other RPM-based distribution users should choose the ".rpm" file. Download it and double-click it to install.

There is also a binary tarball intended to be extracted in your root directory ("/"), which is the file ending with "-bin.tar.gz".

The file ending simply in ".tar.gz" is a source code tarball, which, since this is Python, can be run out of the box simply by running the file "ccgtk" in the "src" directory.


When you first launch CCGtk, it will ask for the URL of your CruiseControl server. To find this, navigate to the CruiseControl dashboard in your browser, look at the address bar, and copy everything before the word "dashboard". (Do not include the word "dashboard".)

For example, if your dashboard is located at http://myserver:8080/dashboard then the URL you should type in is "http://myserver:8080".

The configuration file is located in ~/.ccgtk/config. Each configuration setting is a name followed by "=" and then a value.

To change the URL for the CruiseControl server, modify the "cc_url" setting.

To change how often the server is polled, modify the "poll_interval_secs" setting.

To specify that you are only interested in some of the projects on the server, create one or more "project" settings giving the names of each project whose status you want.

Sample config file:

 # The CruiseControl server.  To find the correct URL,
 # go to the dashboard and copy the address from your
 # browser's address bar, removing the 'dashboard' part.

 # The number of seconds to wait between contacting the server:

 # If you specify no projects, we are interested in all projects on the server.
 # Otherwise, list your projects like this:
 #project=project 1 name
 #project=project 2 name


CCGtk is written in Python and based on the PyGTK python bindings for the GTK/GNOME desktop library.

You can browse the CCGtk source code in the git repository.

You can check out the code like this:

 git clone git://ccgtk.git.sourceforge.net/gitroot/ccgtk/ccgtk

Visit the CCGtk Sourceforge page.

There is developer discussion on the CCGtk Developers Forum.


We welcome bug reports, comments and suggestions.

Discuss CCGtk on the CCGtk Help Forum.

CCGtk is written by Andy Balaam, who may be contacted on axis3x3 at users dot sourceforge dot net.


CCGtk is release under the GNU General Public License version 2 or later, with absolutely no warranty.

Home | Download | Configuration | Development | Contact | License

Edit | History | Print | Recent Changes | Search | Admin Page last modified on February 09, 2010, at 01:00 PM