Download

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.

Configuration

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.
cc_url=http://myserver:8080
# The number of seconds to wait between contacting the server:
poll_interval_secs=300
# 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

Development

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