CCMenu displays the project status of CruiseControl continuous integration servers as an item in the Mac OS X menu bar. Or in other words, CCMenu is to OS X what CCTray is to Windows.
CCMenu allows you to:
- Monitor selected projects on multiple continuous integration servers
- Identify the overall build status with a glance to menu bar
- See the status of individual project builds in the status menu
- Access the build web sites of the projects using the status menu
- See detailed build status information in the projects window
- Receive notification of completed builds via Growl
CCMenu works with all recent versions of CruiseControl, CruiseControl.NET, CruiseControl.rb, and should work with other continuous integration tools that provide status in the CCTray XML format.
The menu
The summary icon in the menu bar and the icons for the individual projects in the menu convey information about the project status:
The most recent build was successful
The most recent build failed
The project is building, previous build was successful
The project is building, previous build was broken
The server is unavailable or returned an invalid status
Clicking on a project in the menu opens the project's web page in the default web browser. Depending on the continuous integration server this can be a project overview page, or a page with details about the last build.
Notifications
CCMenu uses Growl to send notifications when a build has completed. Depending on the previous build status and the result of the current build, it will send one of the following notifications:
- Build successful
- Broken build (previous build successful but current build failed)
- Build still failing (previous and current build failed)
- Fixed build (previous build failed and current build successful)
CCMenu sends all notifications with the default priority and non-sticky. This can be overridden in the Growl preferences pane in the System Preferences application.
Project window
The project window shows more detailed information about each of the projects, including last build time and build label. Note that you can rearrange the columns and sort the view by clicking on the column. These setting and the window size and position are persisted accross sessions.
Configuration
To add a new project, click on the plus icon below the project list in the preferences panel. In the sheet that opens type the URL of the server into the text field or select an existing server from the drop down list.
You have to enter the URL to the actual CruiseControl reporting application, not just the hostname of the CruiseControl server. Provided that you select the correct server type you do not have to enter the actual URL for the cctray resource; you can if you want to, though.
CCMenu remembers the order in which you added the projects to the list but currently does not provide a means to reorder the list later.
