Windows Tray Notifier

Added by Irina Megorskaya, last edited by Irina Megorskaya on Dec 04, 2007  (view change)
Documentation Index

Windows Tray Notifier

The Windows Tray Notifier is a utility that helps you to stay up-to-date with your team's software building process. With the Windows Tray Notifier you:

  • are always logged in to TeamCity,
  • receive notifications only about specific events,
  • monitor desired projects in the Windows Tray.

Installing the Windows Tray Notifier

To install the Windows Tray Notifier:

  1. Navigate to the My Settings & Tools page, and, in the TeamCity Tools area, click the download link under Windows tray notifier.
  2. Wait until the plugin downloads completely.
  3. Run the TrayNotifierInstaller.msi file.

Working with the Windows Tray Notifier

After installing the Windows Tray Notifier, you can continue working in the IDE but effortlessly stay-up-to date with the most recent changes in the project code base using the notifier's various elements:

  • The Notifier Icon
  • The TeamCity Quick View Window
  • Windows Tray Popup Alerts
  • Right-Click Functionality
    Tip
    You can customize your watched projects and build configurations to help avoid information overload and change the information available in the quick view window:
      • Right-click the Notifier Icon and select Configure Watched Builds.
        You will be directed to TeamCity's Windows tray notifier settings page where you can:
      • Select the desired build configurations and events on which you want to be notified.

The Notifier Icon

The Notifier icon appears in Windows System Tray as soon as you launch the Windows Tray Notifier. It shows the status of projects which you (or your TeamCity Administrator) have selected to monitor. The status icon changes to reflect the state of watched projects and build configurations. Here is a list of possible states of the build configurations.

Icon Meaning

Build is successful
Build failed and nobody has taken responsibility

Some team member has taken responsibility for the build failure
The person responsible for the build failure has submitted a fix, but the build has not executed successfully yet

Build configuration is paused, and builds are not triggered automatically

The Notifier icon always shows the status of the last completed build of the your watched project or build configurations, unless you selected Notify when the first error occurs on the Windows Tray Notifier settings page. In this case, the Notifier icon does not wait for the failing build to finish, it displays a failed icon as soon as the running build fails a test.

The TeamCity Quick View Window

A click on the status icon opens the TeamCity Quick View window.


 

Click the results or changes links to navigate to the Build Results and Changes pages in TeamCity's web interface, respectively.

Windows Tray Popup Alerts

Windows tray popup alerts display brief build results information for the specified build configurations and notification events.

 

Click the link on the popup to go the build results page for more details.

Right-Click Functionality

Right-clicking the icon gives you quick access to all of the Windows Tray Notifier's functions.

Option Description
Open Quick View Window Displays the Quick View Window
Go to Projects page... Opens the Projects tab.
Go to My Changes page... Opens the My Changes tab
Configure Watched Builds... Opens the Windows Tray Notifier settings page. Tip: Avoid information overload and customize the quick view window by editing your settings on this page.
Auto Upgrade Select this option to allow the program to automatically upgrade itself.
Run on Startup Select this option to automatically launch the program when windows boots.
About Displays the information on the program's splash screen.
Logout Use this function to log out of the TeamCity server. This will allow you to a different one.
Exit Quits the program

See also:

Labels