## page was renamed from NotificationAreaTransition/Applications
Until mid-2011, we will use this page to track programs running on Ubuntu that need adjusting for [[https://wiki.ubuntu.com/NotificationAreaTransition|the notification area transition]] (as [[NotifyOSD#compatibility|we did for Notify OSD]]). This is so we can easily compare proposed design solutions, and assemble guidelines on how developers should alter any other programs. Once we’ve done that, we’ll retire this page.

== How you can help ==

 * For each program listed here that doesn’t have any issues described, examine it to see where it uses or refers to the notification area (or “tray”). For each place where it does, add a row describing it. If it doesn’t, write in “(none)” followed by your wiki signature (so we know who reviewed it).
 * For each issue, ensure a bug is reported about it, and link to the bug report.
 * For each bug report, ensure that it’s tagged with [[https://bugs.launchpad.net/ubuntu/+bugs?field.tag=trayaway|the “trayaway” tag]].
 * Help fix the bugs. :-)

== Programs ==

http://people.canonical.com/~kees/search-status_icon.log -- needs to be converted into Moin``Moin table rows, sorted, and pasted below

http://people.canonical.com/~kees/search-qt-systemtray.txt -- needs to be converted into Moin``Moin table rows, sorted, and pasted below

http://people.canonical.com/~kees/search-eggtrayicon.txt -- needs to be converted and added to this table. There are also [[http://packages.ubuntu.com/search?keywords=python-eggtrayicon|Python bindings]] shipped in Ubuntu for this as well so any package which depends on that would also be a candidate.

||'''Package'''||<style="width:40%">'''Use/mention of notification area or tray'''||<style="width:40%">'''Recommendation from Design team'''||'''Bug'''||
||abby||“Edit” > “Preferences” > “Misc” has “Minimize to system tray” checkbox.||When notification area is absent, hide this checkbox, and behave as if it is unchecked.|| ||
||acetoneiso||“File” > “Options” > “Advanced Options” has “Tray Icon” section with two checkboxes.||When notification area is absent, hide the “Tray Icon” section, and behave as if both checkboxes were unchecked.|| ||
||alarm-clock||Has always-on alarm clock icon that shows/hides the list of alarms.||Port to a status menu with “Add Alarm…”, “Add Counter…” etc items.|| ||
||alarm-clock-applet||? (Doesn’t seem to use the notification area, even when an alarm goes off.)|| || ||
||amarok||Has custom status menu, but its icons are broken, “Restore” item does nothing when Amarok is visible, and “Settings” > “Configure Amarok” > “General” > “Show tray icon” checkbox does nothing.||Integrate with the [[SoundMenu|sound menu]]. Replace “Show tray icon” checkbox with a “Show Amarok in the sound menu” checkbox.|| ||
||amsn||Uses notification area||Integrate with the [[MessagingMenu|messaging menu]].||Bug:537613||
||ant-phone||? (Doesn’t launch: “You'll need a full duplex soundcard or multiple sound devices compatible and an ISDN card.”)|| || ||
||aqualung||Always-present notification area item that shows/hides the Aqualung windows, and offers basic playback controls.||Integrate with the [[SoundMenu|sound menu]].|| ||
||ario||“Edit” > “Preferences” > “Notification” > “Tray icon” section toggles notification area item that shows/hides the Ario windows, and offers basic playback controls.||Replace the “Tray icon” preferences with a checkbox for whether Ario should appear in the [[SoundMenu|sound menu]].|| ||
||artha||“The hot key set for Artha is Ctrl + Alt + W. Press this key combination to call Artha from the system tray. Selecting text in any window and calling Artha will pop it up with the selected text's definitions. If notifications are enabled, instead of popping up, Artha will notify the first definition of the selection. Notifications can be enabled/disabled by right-clicking on Artha's status icon on the system tray and selecting the required option. Pressing Ctrl + Alt + W actually does nothing, and so does right-clicking on the notification area item.|| ||Bug:598478||
||audacious-plugins||“File” > “Preferences” > “Plugins” > “General” > “Status Icon”||Replace with a plugin that integrates with the [[SoundMenu|sound menu]].|| ||
||avidemux||“Edit” > “Preferences” > “General” > “Use systray while encoding” checkbox hides Avidemux while encoding, showing an animated notification area item instead.||Remove the checkbox, and always behave as if it was unchecked. Consider showing progress in Avidemux’s window icon.|| ||
||ayttm||Always-present notification area item shows/hides main window, and has a menu for basic IM statuses.||Convert to a custom status menu.|| ||
||backintime|| Only appears when backup is in progress. Left-clicking pops up a dialog of specifically what is being checked or backed up at the moment. Right-clicking does nothing. || || ||
||bacula|| || || ||
||balsa|| || || ||
||basket|| || || ||
||brasero||? (testing on 10.04 hindered by Bug:529696)|| || ||
||calibre|| "Preferences" > "Preferences" > "interface" > "Enable system tray icon" puts permanent icon in notification area. Clicking sends calibre to fg/bg. Right click menu has options for donate, eject (ebook device), quit. Hover tip shows actions in progress. On closing the app, "calibre will keep running in the system tray. To close it, choose Quit in the context menu of the system tray."|| || ||
||camorama|| || || ||
||cb2bib|| || || ||
||cellwriter|| || || ||
||choqok||Displays the number of unreaded tweets/messages. Clicking shows/hides the main window and clears the unread messages count. Right-clicking shows a menu with items for quick post, update messages, enable/disable update timer, configure program and quit.||Integrate with the [[MessagingMenu|messaging menu]].|| ||
||chromium-browser|| || || ||
||claws-mail-extra-plugins|| || || ||
||connman-gnome|| || || ||
||cryptkeeper|| || || ||
||dalston|| || || ||
||deja-dup|| || || ||
||deluge|| In Edit->Preferences->Interface there is a System tray section for enabling/disabling the system tray icon, which on mouse-over displays current up- and download speeds and limits, on left click displays/hides the application window, and on right click brings up a menu with the following options : Show Deluge, Add torrent, Pause All, Resume All, Download Speed limit and Upload speed limit with predefined values in submenus to choose from, and Quit ||Convert to a custom status menu.|| Bug:584669 ||
||desktopnova|| || || ||
||drivel|| || || ||
||eclipse|| || || ||
||eee-applet|| || || ||
||efax-gtk|| || || ||
||eiskaltdcpp|| || || ||
||ekiga|| Uses icon similar to Pidgin - Shows current status (online/in-call etc.). Left-click toggles between Ekiga being hidden (not on screen and not minimised to Window List) and visible (on screen plus shown in Window List. Right-click shows the options "Help", "About" and "Quit". The icon can not be disabled within Ekiga's preferences dialog. ||Integrate with the [[MessagingMenu|messaging menu]].|| ||
||elmerfem|| || || ||
||empathy|| Empathy's Contact List has an option under "Preferences > Notifications" to "Show incoming messages in the messaging menu".  If checked, there is no icon in the Notification Area.  If unchecked, there is an icon in the Notification Area that (a) represents your status, (b) alerts you to new messages by blinking, and (c) has a right-click menu with items (1) Show contact list [toggle], (2) New conversation..., (3) New call..., (4) Status [with status submenu], and (5) Quit.  Left-click does nothing other than focus the Contact List window. ||No further changes necessary.|| ||
||epiphany-browser|| || || ||
||esperanza|| || || ||
||evolution|| || || ||
||evolution-rss|| || || ||
||fatrat|| || || ||
||fglrx-installer|| || || ||
||fontmatrix||“Edit” > “Preferences” > “System Tray” screen, with “Show Fontmatrix in System Tray” and several other options.||When the notification area is not available, hide the Preferences section, and always behave as if “Show Fontmatrix in System Tray” is unchecked.|| ||
||fpm2|| || || ||
||fqterm|| || || ||
||ganyremote|| Has an always-on remote controller icon, used to bring up the GUI (left-click) or a context menu (right-click).||Convert to a custom status menu.|| ||
||gajim|| || || ||
||g2ipmsg|| || || ||
||gbemol|| || || ||
||gcin|| || || ||
||geany-plugins|| || || ||
||gemanx-gtk2|| || || ||
||gigolo|| || || ||
||glurp|| || || ||
||gmpc||“Music” > “Preferences” > “Notification Area Icon” section with “Enable” checkbox. On left-click, icon toggles showing the GUI, on right-click, has the options Pause (or Play), Stop, Next, Previous, Playlist (same as left-click, toggles GUI visibility) and Quit.||Integrate with [[SoundMenu|the sound menu]]. (Using [[http://ayeon.org/projects/mpDris/|MpDris]]?) || ||
||gnome-bluetooth|| || || ||
||gnome-applets|| || || ||
||gnome-control-center|| || || ||
||gnome-disk-utility|| || || ||
||gnome-gmail-notifier|| || || ||
||gnome-media|| || || ||
||gnome-mplayer|| || || ||
||gnome-mud|| || || ||
||gnome-phone-manager|| || || ||
||gnome-power-manager|| || || ||
||gnomeradio|| || || ||
||gnome-settings-daemon|| || || ||
||gnome-user-share|| || || ||
||gnote|| GNote is a C++ port of Tomboy, and therefore its notification area icon behaves the same as Tomboys. Needs a port of the Tomboy patch. || || ||
||gnotime|| || || ||
||gnubiff|| || || ||
||gnunet-gtk|| || || ||
||gnunet-qt|| || || ||
||goldendict|| || || ||
||goobox|| || || ||
||google-gadgets|| || || ||
||gringotts|| || || ||
||grsync|| || || ||
||gtk+2.0|| || || ||
||gtk2hs|| || || ||
||gtk-gnutella|| || || ||
||gtkmm2.4|| || || ||
||gtk-sharp2|| || || ||
||gtrayicon|| || || ||
||guake|| Guake is a simple drop-down terminal. Left-clicking shows/hides the application. Right-clicking opens a menu, with options to open a preferences menu, open an about dialog, and quit the application. || || ||
||guayadeque|| || || ||
||guile-gnome-platform|| || || ||
||gwget|| Left-click to show/hide app, Right-click for menu with new download creation, a download list, preferences, and quit || || ||
||gwget2|| || || ||
||hdate-applet|| || || ||
||hplip||The HPLIP notification area item appears whenever you launch “HPLIP Toolbox” or “HPLIP Fax Utility” (but not when you launch “Fax address book”). Clicking it does nothing. Double-clicking it opens the HP Device Manager. Right-clicking it opens a menu with “HP Device Manager”, “Settings”, and “Quit” commands. Choosing “Settings” opens a “System Tray Settings” window, which is a duplicate of the “System Tray Icon” tab in HP Device Manager’s own Settings window, and erroneously suggests the existence of “System tray icon messages” (“All”, “Errors and Warnings”, “Errors Only”, or “None”).|| || ||
||ibm-notes85 || Clicks ignored. Hover informs of mail arrival.|| || ||
||imageshack-uploader|| || || ||
||indicator-application|| || || ||
||iptux|| || || ||
||italc|| || || ||
||java-gnome|| || || ||
||jeex|| || || ||
||k3b|| False positive (non-code reference in docs) || --- || --- ||
||kaffeine|| || || ||
||kbluetooth|| False positive (Old include that was never removed) || --- || --- ||
||kcheckgmail|| || || ||
||kde4libs|| Contains the actual old KSystemTrayIcon widget that apps use, nothing to do here || --- || --- ||
||kdeaccessibility|| || || ||
||kdebase-runtime|| || || ||
||kdebase-workspace|| || || ||
||kdebindings|| || || ||
||kdeedu|| || || ||
||kdegraphics|| || || ||
||kdemultimedia|| False positive for KMix. It uses an enum item from QSystemTrayIcon for compat reasons || || ||
||kdenetwork|| KPPP (dialup manager) docks in the tray || || ||
||kdepim|| || || ||
||kdetoys|| || || ||
||kdeutils|| || || ||
||kdocker|| || || ||
||keepassx|| || || ||
||kepas|| || || ||
||kerneloops|| || || ||
||kfritz|| || || ||
||kftpgrabber|| || || ||
||kgmailnotifier|| || || ||
||klogshow|| || || ||
||kmess|| When clicked shows/hide contact list window. On right click allows to set status, disconnect, configure program, accounts and quit program. || || ||
||kmldonkey|| || || ||
||kmplayer|| || || ||
||knemo|| || || ||
||koffice|| || || ||
||kontrolpack|| || || ||
||konversation|| False-positive for ifdef'd compat code || --- || --- ||
||kpackagekit|| The daemon uses a tray icon to show activity. It has been ported to the new tray spec for KPK 0.6 || || ||
||kradio|| || || ||
||krb5-auth-dialog|| || || ||
||krusader|| || || ||
||kshutdown|| || || ||
||ktorrent|| Left click shows/hides the application. Right click opens a context menu with some basic preferences, operations, and Quit. || || ||
||kupfer|| Kupfer is an application mimicking the app-launching functionality of Gnome-Do. Left-clicking shows/hides the application. Right-clicking shows a menu, with options to open a preferences window, open a help window, open an about dialog, and quit the application. || || ||
||kvirc|| || || ||
||kvkbd|| || || ||
||kvpnc|| || || ||
||kx11grab|| || || ||
||lablgtk2|| || || ||
||lastfm|| Left click shows/hides the application window. Right click displays a context menu with items: Open, basic preferences (My Last.fm Page link, [x] Enable scrobbling, Change user submenu), song-related operations (Share, Tag; Love, Ban; Play/Stop, Skip), and Quit. Song-related items are enabled/disabled depending on whether a song is playing or not. || || ||
||lazarus|| || || ||
||lernid|| || || ||
||libgnomekbd|| || || ||
||libgtk2-perl|| || || ||
||libnotify|| || || ||
||libwnck|| || || ||
||licq|| || || ||
||liferea|| Liferea, by default, has an icon in the tray. It shows when RSS feeds are updated, and optionally how many new items exist. Left-click shows/hides application. Right-click shows menu, with options to work offline, update all feeds, open the preferences menu, show/hide Liferea, and quit. || ||Bug:540490||
||linphone|| || || ||
||linuxdcpp|| Preferences -> Appearance -> Options fieldset -> Show status icon. If checked, LinuxDC++ always shows a symbol in the notification area with options: "Show/hide interface" and "Quit". || || ||
||lua-gtk|| || || ||
||luckybackup||Displays an icon upon start and during simulation and backup. || || ||
||lxmusic|| || || ||
||macopix|| || || ||
||mail-notification || Displays an icon on new mail (supports local mbox, maildir, POP3, IMAP, Gmail, Evolution). On left click executes the configured action (e.g. open the mail reader) and a context menu on right click (Open mail reader, Mark mail as read, Update, Properties). [[http://www.nongnu.org/mailnotify/|Homepage]] || || ||
||mangler|| Voice chat (ventrillo) client from PPA, will be in archive soonish: displays own icon in tray, icon changes color when the microphone is active (usually because user is pressing push-to-talk button, but also when mic auto-activation is on).  Push to talk activation is generally accompanied by a "ding" sound.  Clicking the icon brings main mangler window to front, in focus. || || ||
||minbar||Icon appears once opened and program reduces to tray when closed. Left click brings up the window, right click presents a menu. || || ||
||monkeystudio|| || || ||
||mountmanager|| || || ||
||mumble||“Configure” > “Settings” > “User Interface” > “Tray Icon” section with two checkboxes (one of them shown only when “Advanced”)||When notification area is absent, hide the “Tray Icon” section, and behave as if both checkboxes were unchecked.||Bug:584214||
||museek+|| || || ||
||musescore|| || || ||
||nagstamon||It's the main interface. Click on the icon to open a floating window with data|| || ||
||nautilus|| || || ||
||nautilus-dropbox ||Doesn’t have an application window per se. Notification icon displays dropbox logo with an overlay icon indicating synchronization status of the dropbox folder. Hover displays two lines: "Dropbox <version>" and the current sync status (e.g. "All files up to date"). Left-click opens the user's dropbox folder in Nautilus. Right-click provides a context menu: "Open Dropbox Folder" (same as left-click), "Launch Dropbox Website", "Recently Changed Files" menu, disabled item indicating used space in online dropbox folder (e.g. "6.7% of 2.5GB used"), disabled item indicating sync status (e.g. "All files up to date"), Help menu (sub-items are Help Center/Tour/Forums), "Get more Space" (opens browser with info about dropbox plans), "Preferences..." (opens prefs app that doesn't appear to be accessible any other way), "Stop Dropbox". Preferences window contains various options, including this checkbox option: "Show system tray notifications". Note that nautilus-dropbox provides access to Dropbox which is similar to Ubuntu One, so perhaps we could take UI cues/recommendations from what is being done with Ubuntu One (provided there aren't any functional regressions) it has libappindicator support in it's experimental builds.||Dev builds of dropbox use app indicators, so we probably won't need to do anything for it depending on when they release. --[[LaunchpadHome:jorge]]|| ||
||network-manager-applet|| On click displays a menu with the available networks (be they wireless or wired), an option to disconnect from one being used, ability to connect to a hidden wireless network, create a new one and a menu with VPN connections. || || ||
||nuapplet|| || || ||
||ogmrip|| || || ||
||open-vm-tools|| || || ||
||openoffice.org||“Tools” > “Options…” > “Open``Office.org” > “Memory” > “Open``Office.org Quickstarter” > “Enable systray Quickstarter”||Remove this section, and always behave as if the Quickstarter is turned off.||Bug:230196||
||opera||Allows show and hide as well as a number of other options.  Option "opera -notrayicon" not available anymore at least as of version 10.60.|| || ||
||orage|| || || ||
||osmo|| || || ||
||oss4|| || || ||
||packagekit-gnome|| || || ||
||padevchooser|| || || ||
||parcellite||When launched it goes directly to the tray, without showing anything. ||It should show preferences on the first run, and then go to a Status menu (maybe the same of the keyboard layout?)|| ||
||parcellite||In the preferences: "Actions" tab - ctrl-click on the tray icon to use actions||There's also a keyboard shortcut to use those actions. Remove the reference altogether.|| ||
||pcmanx-gtk2|| || || ||
||pidgin|| When clicked shows/hide buddy list window. If there's a new message, when clicked it jumps to the chat window (very useful feature). On right click it displays a menu which allows to change status, switch off various options (sounds, notifications, buddy list), allows to select accounts, plugins and preferences. Inside Preferences > Interface, there's an option to disable it. || || ||
||plymouth|| || || ||
||policykit-1-gnome|| || || ||
||psi|| || || ||
||psi-plus|| || || ||
||pygtk|| || || ||
||python-eggtrayicon||Library.||When invoked, print a debug message warning that the notification area is being removed.|| ||
||python-qt4|| Library containing the actual QSystemTrayIcon python bindings, false positive ||When invoked, print a debug message warning that the notification area is being removed.|| --- ||
||qbittorrent|| || || ||
||qdacco|| || || ||
||qelectrotech|| || || ||
||qjackctl|| || || ||
||qmmp|| || || ||
||qnapi|| || || ||
||qorganizer|| || || ||
||qstardict|| || || ||
||qsynth|| || || ||
||qt4-x11|| False positive, library containing the actual QSystemTrayIcon that apps use ||When invoked, print a debug message warning that the notification area is being removed.|| --- ||
||qtcreator|| || || ||
||qtemu|| || || ||
||qterm|| || || ||
||qtm|| || || ||
||qtscriptgenerator|| False positive, this is a library, sort of || --- || --- ||
||qtsmbstatus|| || || ||
||quassel|| False positive for ifdef'd compat code || --- || --- ||
||quicksynergy||Always-present icon. Left-click shows settings, right-click shows menu to open settings or quit. || || ||
||quitcount|| || || ||
||quodlibet-plugins||"Music" > "Plugins" > "Tray Icon"; "Music" > "Plugins" > "Notify"|| || ||
||qutim|| || || ||
||qwit|| || || ||
||radiotray|| Menu on leftclick to choose the station and to turn radio on and off, menu on rightclick to configure radios, display About dialog and quit.|| || Bug:600542 ||
||recorditnow|| || || ||
||rep-gtk|| || || ||
||rgtk2|| || || ||
||rhythmbox||Has already been integrated into the sound menu? || || ||
||rsibreak|| || || ||
||ruby-gnome2|| || || ||
||salasaga|| || || ||
||scim|| || || ||
||seahorse-plugins|| || || ||
||setroubleshoot|| || || ||
||shutdown-qapps|| || || ||
||shutter|| Left click to open/close app, Right click to use screenshot functions (its purpose) || || ||
||skrooge|| || || ||
||smb4k|| || || ||
||smplayer|| || || ||
||snd|| || || ||
||soundkonverter|| || || ||
||speedcrunch|| || || ||
||stardict|| Left click to minimize/unminimize from tray, right click to stop automatic text scanning or to quit the application || || ||
||swt-gtk|| || || ||
||sylpheed|| || || ||
||symphony (IBM Lotus)|| Double-Click opens Symphony. Rt-Click: Launch, Exit menu. It's a dll preloader|| || ||
||synce-trayicon|| || || ||
||touchfreeze|| || || ||
||tracker|| || || ||
||transmission|| || || ||
||truecrypt||When running Truecrypt encryption program and mounting a volume, Truecrypt minimizes into the Systray. I have not found a way to get the Truecrypt program back again; and as consequence, cannot unmount encrypted partitions; cannot mount more volumes; basically, cannot do anything... || || ||
||tucan|| "View" > "Preferences" > "Advanced Configuration" has "Close to tray" checkbox. Left click shows the window, right click brings up a menu with the options: "Preferences", "About" and "Quit". It's written in Python and uses the "gtk.StatusIcon()" object to create its tray icon.|| || ||
||twitux|| || || ||
||txtreader|| || || ||
||uget|| || || ||
||update-notifier|| || || ||
||usermode|| || || ||
||vagalume|| || || ||
||valknut|| || || ||
||vidalia|| || || ||
||vino|| || || ||
||virtualbox-ose|| || || ||
||vlc|| "Tools">"Preferences">"Interface tab">"Show an icon in the systray" (Barre système in french). Right click on this icon show a menu with Play, Stop... Maybe integrate VLC in the Sound Menu?)|| || ||
||wally|| || || ||
||webissues|| || || ||
||wine|| Many Windows applications use the system tray (e.g. Spotify). Behaviour depends on the specific application. || || ||
||winwrangler|| || || ||
||wpasupplicant|| || || ||
||xchat||“Quit XChat?” alert has “Minimize to Tray” button.||Remove the button.||Bug:584204||
||xchat||“Alerts” Preferences has row of “Show tray balloons on” checkboxes.||Change “tray ballooons” to “notification bubbles”.||Bug:584207||
||xchat||“Alerts” Preferences has row of “Blink tray icon on” checkboxes.||When notification area is absent, hide the row of checkboxes, and behave as if all are unchecked.||Bug:584210||
||xchat||“Alerts” Preferences has “Enable system tray icon” checkbox.||When notification area is absent, hide the checkbox, and behave as if it is unchecked.||Bug:584212||
||xchat-gnome|| || || ||
||xfce4-clipman-plugin|| || || ||
||xfce4-notes-plugin|| || || ||
||xfce4-power-manager|| || || ||
||xfce4-volstatus-icon|| || || ||
||xpad|| || || ||
||yarssr||Always-present icon in notification area changes colour when new feed items found. Right- and left-click menus. Icon has tooltip.|| || ||
||yate|| || || ||
||zenity||"--notification" as an option displays "--window-icon" in the tray with "--text" as a tooltip. || || ||

== Comments ==

Maybe we should avoid duplicated efforts by talking to [[http://live.gnome.org/WilliamJonMcCann|WilliamJonMcCann]] who seems to be maintaining a copy of this list [[http://live.gnome.org/GnomeShell/Design/Guidelines/MessageTray/Compatibility|on live.gnome.org]]