ccTrayIcon

Introduction

ccTrayIcon is a Java application which displays a 'traffic light' icon in your system tray, showing the current build status of projects on a CruiseControl integration server.

System Requirements

ccTrayIcon should run on any platform supported by JDIC, ie Windows, Solaris and Linux.

Unfortunately JDIC's Tray API doesn't yet support Mac OS X, but Mac support will be added to ccTrayIcon as soon as it becomes available. In the mean time, a dummy Swing implementation of the API is used when running on a Mac, which runs in a small window rather than in the dock or menubar. This is only really there to allow me to develop the applciation on my Mac, and is not intended for serious use. Mac users may wish to try rubiCore's CruiseControl Widget instead.

Installation

The easiest way to install and run ccTrayIcon is by using Java Web Start. Assuming you have Java installed, simply click the link below to run the application:

ccTrayIcon Web Start

If your browser is not configured to run Web Start applications automatically, you can save the file and run it yourself, either by launching it directly, or faililng that using the javaws application which should be in the bin directory in your Java installation.

More information about Java Web Start can be found here.

Running and Configuration

To run the application again, simply execute the saved JNLP file.

Currently, the only configuration possible is setting the CruiseControl server URL. To do this, right-click on the icon, and select "Choose Server...".

Support

To report a bug, request a new feature or ask for help, please use the appropriate facility on the project's SourceForge page.

Building

Obtain the ccTrayIcon sources from the project's SourceForge page, either as part of a released build or using CVS. To build the application, follow these steps

  1. Install Apache Ant.
  2. If you are modifying the code, and need to run the unit tests, follow these additional steps. Otherwise, comment out easymock.dir and checkstyle.jar in build.properties.
    1. Install JUnit.
    2. Copy junit.jar from JUnit's installation directory to ant's lib directory.
    3. Install EasyMock.
    4. Set easymock.dir in build.properties to point to the directory where you installed EasyMock.
  3. Install JDIC.
  4. Set up a dummy key for signing the JAR files, as described here
  5. Set jdic.dir in build.properties to point to the directory where you installed JDIC.
  6. Run ant from the ccTrayIcon root directory.

The project's JavaDoc documentation can be found here.

Licence

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

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