CompatibilityFixes

Differences between revisions 77 and 78
Revision 77 as of 2010-07-15 14:20:12
Size: 22528
Editor: eth0
Comment: fixes nautilus-dropbox table row
Revision 78 as of 2010-07-15 14:30:05
Size: 22821
Editor: eth0
Comment: + recommendations for python-eggtrayicon, python-qt4, qt4-x11
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
To add to the lists above, I would suggest also searching for any instances of eggtrayicon (EggTrayIcon / egg_tray_icon etc) which preceded GtkTrayIcon and was simply copied and pasted into a lot of programs before GtkTrayIcon was added to GTK. 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. To add to the lists above, I would suggest also searching for any instances of eggtrayicon (EggTrayIcon / egg_tray_icon etc) which preceded GtkTrayIcon and was simply copied and pasted into a lot of programs before GtkTrayIcon was added to GTK. 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.
Line 209: Line 209:
||python-qt4|| Library containing the actual QSystemTrayIcon python bindings, false positive || --- || --- || ||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.|| --- ||
Line 219: Line 220:
||qt4-x11|| False positive, library containing the actual QSystemTrayIcon that apps use || --- || --- || ||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.|| --- ||

Until mid-2011, we will use this page to track programs running on Ubuntu that need adjusting for the notification area transition (as 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 the “trayaway” tag.

  • Help fix the bugs. Smile :-)

Programs

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

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

To add to the lists above, I would suggest also searching for any instances of eggtrayicon (EggTrayIcon / egg_tray_icon etc) which preceded GtkTrayIcon and was simply copied and pasted into a lot of programs before GtkTrayIcon was added to GTK. There are also Python bindings shipped in Ubuntu for this as well so any package which depends on that would also be a candidate.

Package

Use/mention of notification area or tray

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 sound menu. Replace “Show tray icon” checkbox with a “Show Amarok in the sound menu” checkbox.

amsn

Uses notification area

Integrate with the messaging menu.

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 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 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.

598478

audacious-plugins

“File” > “Preferences” > “Plugins” > “General” > “Status Icon”

Replace with a plugin that integrates with the 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 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 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.

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 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 the sound menu.

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

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.

540490

linphone

linuxdcpp

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). 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.

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. --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…” > “OpenOffice.org” > “Memory” > “OpenOffice.org Quickstarter” > “Enable systray Quickstarter”

Remove this section, and always behave as if the Quickstarter is turned off.

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.

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

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

winwrangler

wpasupplicant

xchat

“Quit XChat?” alert has “Minimize to Tray” button.

Remove the button.

584204

xchat

“Alerts” Preferences has row of “Show tray balloons on” checkboxes.

Change “tray ballooons” to “notification bubbles”.

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.

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.

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.

NotificationAreaTransition/CompatibilityFixes (last edited 2011-05-27 09:30:28 by c-7f9ae253)