CCMenu displays the build status of projects on a continuous integration server as an item in the Mac's 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 Notification Center or Growl
CCMenu works with CruiseControl, and with CircleCI, Jenkins, Snap CI, TeamCity, ThoughtWorks Go, and Travis CI. It should work with any continuous integration server that can provide status in the “cctray” XML format.
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 project is disabled or waiting for a build agent
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.
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.
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.
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:
CCMenu sorts the projects alphabetically in the menu. Currently there is no way to change this.