FireTray/README.md

Firetray
=======

Overview
--------

Js-ctypes rewrite of the binary XPCOM version of **Firetray**.

Features
--------

* for all applications:
  * show/hide a single or all windows
  * a window gets restored to its previous state, position, size, virtual desktop
  * optional hide to tray on minimize
  * optional start minimized to tray
  * optional show icon only when hidden to tray

* for mail applications:
  * display unread messages count in tray icon
  * customizable tray icon for mail biff
  * include/exclude mail accounts and folders types to/from unread messages count

Notes
-----

* requires GTK+ 2.20 and higher.
* Firetray unsets the `tabs.warnOnClose` built-in preference, which otherwise disrupts the handeling of the close event.
* Experimental non-customizable keyboard shortcut for hiding all windows set to: `accel-shift-w`

References
----------

* if you're looking for other mozilla-desktop integration:
  * Paul Neulinger's [Gnome-shell-Thunderbird integration](https://github.com/tanwald/gnome-shell-extension-thunderbird-integration "gnome-shell-thunderbird integration")
  * Mike Conley's
    [Unity-Thunderbird integration](http://mozillalabs.com/messaging/messaging-menu/
    "Unity-Thunderbird integration")
  * discontinued [Mozilla New Mail Icon (Biff)](https://addons.mozilla.org/fr/thunderbird/addon/new-mail-icon/)

* [Alltray](http://alltray.trausch.us/ "alltray") launches any applications
  into tray

KNOWN BUGS
----------

* windows aren't restored with the same z-order, but there is [no means to correct that under Linux](https://bugzilla.mozilla.org/show_bug.cgi?id=156333 "GetZOrderDOMWindowEnumerator is broken on Linux")

* notifications for excluded mail account servers are not
  disabled. Newmailalerts are
  [hard-coded](http://mxr.mozilla.org/comm-central/find?string=content/newmailalert)
  and we can't easily disable them on a per-server basis (only globally, see
  `mail.biff.show_alert`). The proper way would probably be to disable default
  notifications globally, and handle notifications ourselves. This is out of
  the scope of this addon, but you may want to give a try to the
  [MailAlert extension](https://addons.mozilla.org/en-US/thunderbird/addon/mailbox-alert/)

* child windows (compose message, preferences, ...)  are not handled by
  Firetray. For ex., they are not hidden along with there top-level window.

* because of `getNumNewMessages()`'s
  [strange behaviour](https://bugzilla.mozilla.org/show_bug.cgi?id=727460),
  it's impossible to display an accurate count of *new messages*. The best we
  can do is display a biff icon.

Acknowledgment
--------------

* Some code borrowed from [Mike Conley](http://mzl.la/messagingmenu "Thanks Mike").
* Some code borrowed from
  [Nils Mayer](https://addons.mozilla.org/fr/firefox/addon/minimizetotray-revived/
  "MinToTrayR addon page").
* kind support from Neil Deaking, Bobby Holley
FireTray v0.4.0a2 2011-09-24 06:00:31 -04:00			`Firetray`
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			`=======`
* remember and correct window positions when hiding/showing * fix: prevent multiple handler/icon creations * closing a window hides all windows * add option for 'close_hides' (work in progress) 2011-08-15 16:39:25 -04:00
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			`Overview`
			`--------`

FireTray v0.4.0a2 2011-09-24 06:00:31 -04:00			`Js-ctypes rewrite of the binary XPCOM version of Firetray.`
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00
* fix pref pane (UIOptions) * addon shutdown (close ctypes libs) on xpcom-will-shutdown * ctypes libs that import glib also export it so it can be closed later 2012-01-15 14:47:47 -05:00			`Features`
			`--------`

			`* for all applications:`
			`* show/hide a single or all windows`
add option for showing icon only when some windows are hidden to tray 2012-01-15 17:57:35 -05:00			`* a window gets restored to its previous state, position, size, virtual desktop`
			`* optional hide to tray on minimize`
			`* optional start minimized to tray`
			`* optional show icon only when hidden to tray`
* fix pref pane (UIOptions) * addon shutdown (close ctypes libs) on xpcom-will-shutdown * ctypes libs that import glib also export it so it can be closed later 2012-01-15 14:47:47 -05:00
			`* for mail applications:`
			`* display unread messages count in tray icon`
			`* customizable tray icon for mail biff`
			`* include/exclude mail accounts and folders types to/from unread messages count`

* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			`Notes`
			`-----`

fix keyboard shortcut 2012-01-23 07:15:54 -05:00			`* requires GTK+ 2.20 and higher.`
FireTray v0.4.0a2 2011-09-24 06:00:31 -04:00			* Firetray unsets the `tabs.warnOnClose` built-in preference, which otherwise disrupts the handeling of the close event.
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			* Experimental non-customizable keyboard shortcut for hiding all windows set to: `accel-shift-w`

add unread messages counting facility (messaging-related) 2011-09-07 10:24:14 -04:00			`References`
			`----------`

* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			`* if you're looking for other mozilla-desktop integration:`
			`* Paul Neulinger's [Gnome-shell-Thunderbird integration](https://github.com/tanwald/gnome-shell-extension-thunderbird-integration "gnome-shell-thunderbird integration")`
add unread messages counting facility (messaging-related) 2011-09-07 10:24:14 -04:00			`* Mike Conley's`
			`[Unity-Thunderbird integration](http://mozillalabs.com/messaging/messaging-menu/`
			`"Unity-Thunderbird integration")`
begin implementation for text icon 2011-09-09 16:14:40 -04:00			`* discontinued [Mozilla New Mail Icon (Biff)](https://addons.mozilla.org/fr/thunderbird/addon/new-mail-icon/)`
add unread messages counting facility (messaging-related) 2011-09-07 10:24:14 -04:00
			`* [Alltray](http://alltray.trausch.us/ "alltray") launches any applications`
			`into tray`
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00
			`KNOWN BUGS`
			`----------`
* remember and correct window positions when hiding/showing * fix: prevent multiple handler/icon creations * closing a window hides all windows * add option for 'close_hides' (work in progress) 2011-08-15 16:39:25 -04:00
cleaning 2011-08-27 11:40:27 -04:00			`* windows aren't restored with the same z-order, but there is [no means to correct that under Linux](https://bugzilla.mozilla.org/show_bug.cgi?id=156333 "GetZOrderDOMWindowEnumerator is broken on Linux")`
* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00
update README/TODO about disbabling newmailalerts for excluded accounts 2011-11-27 21:52:41 -05:00			`* notifications for excluded mail account servers are not`
			`disabled. Newmailalerts are`
			`[hard-coded](http://mxr.mozilla.org/comm-central/find?string=content/newmailalert)`
typo + bump maxVersion for seamonkey 2012-02-03 16:25:40 -05:00			`and we can't easily disable them on a per-server basis (only globally, see`
update README/TODO about disbabling newmailalerts for excluded accounts 2011-11-27 21:52:41 -05:00			`mail.biff.show_alert`). The proper way would probably be to disable default
			`notifications globally, and handle notifications ourselves. This is out of`
			`the scope of this addon, but you may want to give a try to the`
			`[MailAlert extension](https://addons.mozilla.org/en-US/thunderbird/addon/mailbox-alert/)`
update README/TODO + bump maxVersion to 10.* for FF and TB 2011-11-24 17:12:13 -05:00
* fix UI updating when toggling hides_single_window, show_icon_on_hide * add popup menu items for hidden windows to be shown individually I'm not quite satisfied with the global design/partitioning of the code accross namespaces. Some ideas to explore: extract code related to the popup menu, don't "wrap" window-related function into the Handler. 2012-01-20 17:44:57 -05:00			`* child windows (compose message, preferences, ...) are not handled by`
			`Firetray. For ex., they are not hidden along with there top-level window.`

prevent usage of msg count with type 'new messages' There seems to be no consistent way to count new messages. Tried with 'BiffState', 'NumNewBiffMessages', 'NewMessages'... either the proper event is not fired, or the count is incorrect at a specific event... It was even non-trivial to display an accurate biff. 2012-02-20 18:09:40 -05:00			* because of `getNumNewMessages()`'s
			`[strange behaviour](https://bugzilla.mozilla.org/show_bug.cgi?id=727460),`
			`it's impossible to display an accurate count of new messages. The best we`
			`can do is display a biff icon.`

* refactor handeling of 'close_hides': eventListeners("close") never removed from windows. Pros: reads much simpler. Cons: unnecessary eventListeners (but not harmful either). * experimental kb shortcut for hiding all windows (whatever the value of 'close_hises') * bumped to version 8.* (FF, TB) 2011-08-27 21:35:55 -04:00			`Acknowledgment`
			`--------------`

			`* Some code borrowed from [Mike Conley](http://mzl.la/messagingmenu "Thanks Mike").`
FireTray v0.4.0a2 2011-09-24 06:00:31 -04:00			`* Some code borrowed from`
			`[Nils Mayer](https://addons.mozilla.org/fr/firefox/addon/minimizetotray-revived/`
			`"MinToTrayR addon page").`
* fix openBrowserWindow() when called from GtkMenuItem * add openMailMessage() to popup menu * add start_hidden option * fix getXWindowDesktop() 2012-01-14 19:02:00 -05:00			`* kind support from Neil Deaking, Bobby Holley`
FireTray v0.4.0a2 2011-09-24 06:00:31 -04:00