This documentation in intended to list and describe everything that the extension can do.
Minimizing the window
There are many ways that a window can be minimized.
- Using the menu item
There is a menu item for MinimizeToTray located near the end of the File menu. This will minimize the current window to the tray.
- Using the keyboard short cut
Pressing the keyboard shortcut at any time will also minimize to the tray. This shortcut is listed next to the menu item. In the English locale it is Ctrl+Shift+M.
- Using the toolbar button
There is a toolbar button provided for the extension. It is not added to the toolbar by default, and can be found by going to the View menu, then Toolbars then Customize... . From the window that will open it can be dragged to the toolbar.
- Pressing the window minimize button.
If one of the window control buttons (the normal three up the top right) is pressed with the right mouse key the window will also be minimized to the system tray. In addition if this is down while pressing the Ctrl key, all windows will be minimized. This only works on Microsoft Windows.
Using the Quick Launch
MinimizeToTray Plus has a feature, that for lack of a better name, will be called quick launch. The uses of this feature, and its implementation vary depending on the application. The effect is the same though, a window is loaded and kept from closing while a tray icon is show.
Uses for this functionality might include.
- If Thunderbird is persistently open open it can continue to check your email.
- If Sunbird is persistently open it can show alerts for events.
- In general it causes the application to "open" much faster then noraml.
This command is invoked opening the application with a command line flag -turbo. This can be added by right clicking on an icon and pressing Properties. On the window that opens there will be a text box labelled Target add -turbo to the end of this. This is the same on Windows and Linux, except Linux may give a different name to the text box, such as Command.
MinimizeToTray Plus settings
Always minimize to the tray instead of to the taskbar
When selected any action that normal would minimize the application to the taskbar will result in the window minimizing to the tray instead. For example clicking the window's minimize button or clicking the window in the taskbar when it is the active window. In addition, if you do either of these while holding down the control key, all windows will minimize.
Minimize to the tray on close
When enabled if the window close button, or a similar action would cause the window to close it is instead minimize to the tray. The window is still closable using the Exit (Linux Quit) command from the File menu or once minimized to the tray via its menu.
Require a double click to restore from the tray
On Linux, there is no double click event that can be recorded for tray icons. So the double click is created by checking how far apart the clicks are. This time is controlled by a setting called extensions.minimizetotray.double-click-speed which does not exist by default, but can be created in about:config. It's value is an integer of the time difference in milliseconds. It defaults to 350 if not present.
Restore window instead of opening new
When selected, windows will be restored instead of a new one opened if the application is opened by a short cut, another application or another event that would otherwise result in a new window being opened.
Always show tray icon
Turning this on has almost the same effect as enabling Quick Launch using the -turbo command line flag. However start up of the application is not effected and the window will display as normal.
Only ever show one tray icon
If enabled minimizing only one icon, that of the Quick Launch will every show. Windows can be restored using a Restore sub menu of the tray icon's menu, or by clicking the icon. Closing the Quick Launch window overrides this setting.
Load application at system startup
This setting causes the application to start in Quick Launch mode when the system starts up.
On Windows this is implemented by adding a setting to the registry. It may be added for all users, if this is possible there is an addition setting shown called For the current user only, if not this option is hidden. Windows Vista or Windows 7 uses may find the setting disabled. You need to either turn off User Account Control (not recommenced) or start the application as administrator when they want to check the setting.
On Linux this setting works by adding a file into ~/.config/autostart/. If this folder does not exist or is not writeable this setting will not work. In addition it will not work if the current application can not be started by typing its name into the console, it has to be findable.
Due to the nature of how these setting are stored, disabling or uninstalling the extension will not turn them off.
Application specific notes
For the download window if the options Minimize to the tray on close is selected will only do so if there are active downloads. Other wise there is no way to close the window.
Songbird uses it's own window controls instead of the normal Minimize, Maximize and Close buttons. For this reason things might not function exactly as described, and the results may be slightly different.