CCMenu

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 or parts of the URL and CCMenu will then try various common locations for the CCTray feed. If your server has a custom configuration you may 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}/cc.xml

You can drag the projects in the list to arrange the order in which they are displayed. Alternatively you can choose to have the projects sorted alphabetically or by last build time. Note, that the preference to sort the projects only affects the menu, not the project list in preferences.

The preferences window is resizable when the project list is shown.

URL schemes (available with CCMenu 13.0 or higher)

CCMenu registers two custom URL schemes. This makes it possible to create links on webpages that, when clicked, will open CCMenu and show a prefilled list of projects to add.

To create a CCMenu link, simply add "ccmenu+" to the beginning of the feed URL. For example, a link to the feed for CCMenu's own CI build would look like this:
ccmenu+https://api.travis-ci.org/repositories/erikdoe/ccmenu/cc.xml

It is not possible (yet) to create links that add a project directly.

Command line configuration

CCMenu stores its configuration using the macOS defaults system, which can be accessed using the defaults command. It is possible to load an initial configuration with a command like the following. CCMenu should not be running when the command is issued.

  defaults write net.sourceforge.cruisecontrol.CCMenu Projects '
  (
    {
      projectName = connectfour;
      serverUrl = "http://localhost:4567/cctray.xml";
    }
  )'

With more command line processing it is obviously also possible to read the existing list, add a new project, and then write the updated list.

Last but not least, the open command can be used to trigger the addition of projects from the command line, e.g.

open ccmenu+http://localhost:4567/cctray.xml

As mentioned above, it is not (yet) possible to create links that silently add a single project.