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 servers 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 can enter just the hostname and CCMenu will then try many common locations for the CCTray feed. If your server has a custom configuration you might have to enter the full URL for the feed.
CCMenu sorts the projects alphabetically in the menu. Currently there is no way to change this.
