Jenkins : Firefox Add-on Build Monitor

Plugin Information

No information for the plugin 'firefoxaddon' is available. It may have been removed from distribution.

This plugin is up for adoption. This add-on is looking for a co maintainer. Contact cliffano@gmail.com Click here to learn more!

Monitor Jenkins builds and display the status on Firefox status bar. Use Jenkins Build Monitor to keep track of Jenkins builds. Add Jenkins feed URL to Build Monitor and an icon representing the builds status will appear on Firefox status bar.

Either mouse over the status icon to view the tooltip and quickly check the builds information, or left click the icon and select a build page to open. It's also easy to trigger a build by using one of the menu options.

Download & Installation

Visit https://addons.mozilla.org/en-US/firefox/addon/7522 and click 'Add to Firefox' button.

Starting Firefox 4, Jenkins icon is displayed on add-on bar. An add-on bar is disabled by default (at least as of Firefox 4 Beta 7), you have to manually enable it.
On OS X: View -> Toolbars -> Add-on Bar.
Windows & Linux users? Please leave a comment with the instruction on how you enabled the Add-on Bar, I'll add it to this section.

OS X users are required to configure Firefox:

  • type about:config on Firefox URL bar, press enter
  • search for browser.preferences.instantApply , the default value on OS X is true, set this to false

This change is needed due to a problem with preference accept button behaviour with FF3.* on OS X, more info is available from http://forums-test.mozillazine.org/viewtopic.php?f=19&t=698285 .
By setting instantApply to false, you'll have to click OK button when you change FF Add-on Preferences.

OS X users are also required to install Growl to provide alerts service on Firefox.

FAQ

  1. Q: How to add a feed to be monitored?
    A: Go to your Jenkins web page. If you're on the dashboard or view page, the Jenkins feed links are located at the bottom right area. If you're on a job page, the feed links are at the left area bellow the build history. Right clink on a feed link (for all, for failures, or for just last builds), select Add Link To Jenkins Build Monitor. Provide a name and click OK.
  2. Q: How to monitor a group of jobs?
    A: You can either add the feeds of those jobs one by one, or you can create a view that contains only the jobs that you want and then add the feed link of that view.
  3. Q: How to display only the latest build status?
    A: Go to Preference -> Display -> select latest build from the drop down list.
  4. Q: I'm using OS X and Growl, I'm getting error message "Unable to add link" when I try to add a Jenkins feed link, and on the error console I see error "Component returned failure code: 0x80570016 (NS_ERROR_XPC_GS_RETURNED_FAILURE)".
    A: The first thing you should try is to uninstall then reinstall Growl. If that doesn't work, try a new Firefox.dmg installation, or try a fresh Firefox profile. Check out the comments section on https://issues.jenkins-ci.org/browse/JENKINS-8899

Usage

  1. After restarting Firefox following an installation, a Jenkins icon will appear on Firefox status bar panel.
  2. Go to your Jenkins web site, right click on a feed link (i.e. "for all", "for failures", or "for just last builds" links) and select "Add Link To Jenkins Build Monitor" from the menu.
  3. Provide a name for the feed, then click OK. Build Monitor will suggest a name for the feed depending on whether the feed is for the whole Jenkins instance, or specific to a particular job.
  4. The feed status icon will appear on Firefox status bar. Mouse over it to see the build details on a tooltip. If you want to visit any of those builds' web page, left click the weather/orb icon, and a build menu will appear. Click on any of the build items to open the corresponding build web page.
  5. Preferences window can be opened via right click menu of a status icon.

Check out the demo video of Build Monitor 0.9.

Translation

Build Monitor has been translated to French, Indonesian, and Japanese. If you're interested in helping with the translations, please submit a patch to the issue tracker. If you have commit rights, please feel free to add the translation yourself.

To add a new locale, please follow these steps:

  1. Fork https://github.com/jenkinsci/firefox-extension-buildmonitor .
  2. Add new locale directory under /src/main/resources/firefox/chrome/locale directory.
  3. Add buildmonitor.dtd and buildmonitor.properties files in that directory. Have a look at en-US locale directory as example, copy paste the content to the new locale files, translate the value of each property.
  4. Add the new locale to /src/main/resources/firefox/chrome.manifest
    locale    buildmonitor   <new_locale>    jar:chrome/buildmonitor.jar!/locale/<new_locale>/
    
  5. Submit a pull request.

Screenshots


 

 

 

Credits

Icons from Tango Desktop Project.

Sound effects from the freesound project: