CCMenu

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.

Screenshot: CCMenu

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 Notification Center or Growl

CCMenu works with all recent versions of CruiseControl and should work with other continuous integration servers as long as they can 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

Screenshot: CCMenu growl notification CCMenu sends 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
  • Build broken (previous build successful but current build failed)
  • Build still broken (previous and current build failed)
  • Build fixed (previous build failed and current build successful)

Older versions of CCMenu, for OS X Lion and earlier, use Growl to send notifications. Growl notifications can be configured 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

Screenshot: CCMenu growl notification 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. If you are using Travis CI please enter a URL of this form:

https://api.travis-ci.org/repositories/{user}/{repo}

CCMenu sorts the projects alphabetically in the menu. Currently there is no way to change this.