Options
Here you can set all the default options for PopTrayU. Once you change any option the save button becomes available. You have to save the options for the change to stay in effect after you quit PopTrayU.

A Help button can be found in the lower left corner of the screen. A Quick Help is also available if you click on the button just next to the Help button and right click the item you want help with.

All options are saved in PopTray.ini in your PopTrayU program directory. PopTrayU saves all its settings in the PopTray.ini file and Rules are saved in the Rules.ini file. You can specify a different directory for the files on the command-line.

By using the command-line
"C:\Program Files\PopTrayU\PopTrayU.exe" "%USERPROFILE%"
or
"C:\Program Files\PopTrayU\PopTrayU.exe" "%HOMEDRIVE%%HOMEPATH%"
your PopTray.ini file will be created in your user home directory, which is different for each user on the PC.

Interval:
Rep
How Often Should PopTrayU check for New Mail?
Interval (Check for mail every...minutes) Global Timer for all accounts (in minutes). No checking will happen if you disable AutoCheck from the Tray Menu.
Don't automatically check for new messages Causes PopTrayU not to check for new messages on a timer, but only when manually requested. Same as setting the interval to 0. This option replaces the "never" button in older versions.
Set Interval per Account Checking the Interval per Account buttons removes the global setting, and you must set the interval in the accounts screen.
Interval Check Conditions
Only Check When Already Online First check if you are on-line before checking for e-mail. Used by dial-up users who don't want the dial-up dialog to pop-up when you are not connected. Makes connecting a little bit slower. Was called "Check if on-line" in older versions.
AutoCheck only when Minimized The automatic checking for mail will only happen while PopTrayU is minimized. This option is to prevent errors of your working with message (preview/delete) and PopTrayU checking at the same time, and thus giving lock errors.
Don't Check Between This will suspend auto-checking for mail during the hours specified.

Defaults:
E-Mail Program The default E-mail Client you want to run when your press the "Run E-mail Client" button on the Mail List screen.
Double-Clicking can be customized to run this program.
Next to the Program Box is a "Test" button. Use this button to make sure you can run the program successfully.
Default Sound The WAV file that will be played when you receive new mail on any account where you haven't specified a sound in the account details.
Language This is a list of languages that PopTray has been translated into. Pick the language you want to use, and when you save the options, the interface will be translated instantly.

Any volunteers who want to translate PopTrayU into other languages are welcome to contact the project's developers.
User Data Folder Shows the location PopTrayU is getting the user settings from, such as poptray.ini and blacklist/rules files. This field is purely informational, and setup must be re-run or a command-line switch specified to change the value of this field.

General Options:
Startup
Check for New Mail on Startup Immediately check for mail when PopTrayU starts. Optionally you can set it to wait a few moments after PopTrayU starts before checking. This is handy when your internet connection hasn't been established yet.
Start Minimized PopTrayU will startup in minimized state. Thus the window will be hidden and only the tray icon will be visible.
Tray Icon
Rotate Icon for each Account Animated Tray Icon rotating to show the number of messages in each account one at a time. The account the messages are in can be identified by the color of the circle. When disabled, the total number of messages in all accounts will be shown and the color will be a blend between the colors of accounts with new messages.
Reset Mail Count in Tray when Viewing Reset the Message Count shown in the Tray Icon when you view the PopTrayU mail list screen. When new mail arrives only the new count since last view will be shown. Messages are also marked as Viewed.
Tray Icon While Checking Allows you to select which icon will be shown in the tray while PopTray is busy checking for new mail. (previously on advanced ui screen)
New Message Notification
Flash Tray Icon Animate the Tray Icon when you receive new mail. This will produce a flashing indicator instead of the normal static one. Option previously named "Animated Tray Icon"
Show Balloon Notification On Win2000 and later, a balloon will pop-up showing you the total number of messages in each account. When the "Use Deluxe Balloon" option is checked, a window with more details will pop-up instead. Previously named "Info Balloon on Notification"
Use Deluxe Balloon Show a pop-up window with new messages and account summary instead of the balloon info. The window will close automatically after the specified number of seconds. Setting the interval to 0 will cause the pop-up window to stay open indefinitely. Previously named "Advanced Show Info".
Show Main Window Show the PopTrayU Mail List window when new mail arrives. Previously called "Show Window on Notification".

Advanced Options:
Advanced POP Settings
Connection TimeOut The number of seconds to wait before giving a timeout error when connecting to the mail server.
Enable Quick Checking When checking for new mail PopTrayU will use the POP3 UIDL command to quickly check the ids of all messages on the server. Only new messages identified will be downloaded. This speeds up checking significantly. Switch this option off if your mail server has problems with the UIDL command.
Safe Delete (using UIDL) Whenever you want to delete a message, PopTray will use the POP3 UIDL command (if your server supports it) to get a unique identifier of the message. This is used to make sure that the message you are about to delete is still the same message on the server. (Previously on Advanced Misc Screen)
Error Handling
Ignore Connection Errors When an errors occurs while connecting this option will supress the pop-up error dialog. See the account status bar for the last error.
Ignore Retrieve Errors Ignore errors reported by the server when retrieving messages. Use this option when keep getting "Unable to Retrieve Message" errors.
Show Errors in Balloon Popups When checked, PopTrayU will display retrieve errors (eg: connection timeout/socket error) in a balloon popup instead of a modal dialog. This changes the behavior when the main window is showing to be the same as when the main window is minimized. Enable this option if you get annoyed by error dialogs getting hidden under the main window, but do not wish to completely suppress error notification. If ignore retrieve errors is specified in addition to this option, ignore retrieve errors will take precedence.
Message Download
Preview Top Lines When previewing a message only the specified number of lines will be downloaded, and not the complete message. Since the message will be incomplete, attachment processing won't happen and you will only see the raw message.
Retrieve Body while Checking Allows PopTrayU to download the body as well as the mail headers from the server. When enabled, PopTrayU will allow you to select the body as an area for testing with the rules you have defined.
This will slow down checking, it is more noticable on a slow connection.
To prevent PopTrayU from retrieving huge messages while checking, you can specifiy a maximum size to download and you can also limit the number of lines to download.

Advanced Options - Main Window:
Main Window Message List
Indicate Viewed and Unviewed Message Unviewed messages will be shown in bold text and views messages will be in normal text.
Remember Viewed Messages The message IDs you have viewed will be saved to a file, so the next time you open PopTray it will remember which messages have been viewed. Previously on Advanced Misc page.
Hide Viewed Messages If enabled, once you've viewed a message in the Mail tab, the message will become hidden after subsequent checks. The Hide button, if enabled on the toolbar, can toggle the viewed messages as hidden or shown.
Show Messages while Checking PopTray will begin listing each message as it finds them on the mail server to the Mail List Screen instead of waiting for all of the messages to be read before listing them.
Use Custom Date Format If enabled, a custom format string can be provided to change the display of the date column in the main window to display the date and/or time as the user wishes. See date format options.
Main Window Behaviors
Stay on Top Always show the PopTray window on top of other windows. This setting requires a restart of PopTray to work.
X Button Minimizes The X close button in the top right-hand corner will minimize PopTray instead of closing it. If Enabled, to close PopTray just use "Quit" in the Tray Menu.
Minimize to Tray Minimize PopTray to the System Tray instead of the Taskbar.
Multi-line Account Tabs On the Mail and Account screens, your defined accounts are shown as tabs at the top with scroll buttons when they are wider than the screen. When you enable this option, the tabs will cascade to multiple lines instead.
Double Click Delay on Click When you Click on the Tray Icon, a delay will occur, to see if you are about to double-click, before executing the Click action. When this option is Off, a single-click will immediately execute, and if a double-click occurs, it will execute again.

eg. If Left-Click is assigned to show the messages, and you double-click the tray, it will show the messages immediately, then hide them again before executing the double-click action.
Password Protect PopTrayU will ask for a password before showing the mail list screen. If you select this option a box will appear where you should type the password you want. Only use this option together with the "Minimize to Tray" option.
Default Spam Toolbar Button Action On the main-window toolbar, there's a button called "Spam" with a drop-down with various spam-related action. With this option, you can change which option is shown on the main-toolbar without having to use the drop down menu. The default is a (no action) button labeled spam. Other choices include a button to delete messages marked as spam or to mark the selected messages as spam.

Advanced Options - Miscellaneous:
Message Deletion
Deletion Confirmation When using the "Delete" button, PopTrayU will ask for confirmation before deleting any messages. Deleting messages using rules will not ask for confirmation. Previously on UI Tab.
Extra Confirmation when Deleting Protected Messages If enabled, PopTrayU will require an extra confirmation before deleting messages that have been protected.
Delete Mail only on Next Check Allows PopTrayU to only mark messages for deletion instead of deleting them immediately. This allows time to make changes to the selections and also uses your internet connection more efficiently. The next time after PopTrayU checks for new messages, PopTrayU will finally delete the selected messages from the e-mail server. Previously on general tab.
Mail Client Communication
MAPI instead of mailto: By default PopTray uses a "mailto" URL link to ask your e-mail client to create a message (when clicking New Message or Reply). By setting this option, PopTray will use the Simple MAPI interface to communicate with the e-mail client. If your e-mail client supports a MAPI interface, this will probably give more reliable results.
Rules/Blacklist
Log Rules Write all rules actions to a log file. On each rule is an action you can switch off so that it doesn't get logged.
Note: RULES.LOG is in the same directory as the PopTray user files unless the command-line options have been used to specify a different directory.
Black List mark as Spam Normally all mail from anyone in the black list will be deleted. With this option it will be marked as spam instead of deleted.
Message Preview Options
Disable HTML Preview When enabled, this option makes the "HTML view" tab on the Preview window disabled. This option was created for users who are paranoid about not loading spam tracking images without setting Internet Explorer to offline mode.

Mouse Button Actions:
Show Messages Show the main PopTray window, with the Mail List Screen selected.
Pop-up Menu Show the Tray Pop-Up Menu at the current mouse cursor on the Mail List screen and the Tray Icon.
Check for Mail Check all Accounts for New Mail.
Run E-mail Client Run the E-mail Client specified in "E-mail Program" on the Option Defaults tab.
Check and Show Check all Accounts for New Mail, and if any messages are found, it will show the main PopTray Mail List Screen.
Show Info Show how many messages in each of your accounts. On newer versions of Windows (Win2000,WinXP,WinME) the info will show in a balloon hint for 30 seconds, otherwise a normal dialog is displayed.
Check and Info Check all Accounts for New Mail, and if any message are found show the Info message.
Toggle Message Window Show the Message Window if it's hidden. If it is visible it will minimize it.
Toggle AutoCheck Toggle the Status of AutoCheck. The Tray Icon will change to indicate that AutoCheck is switched off.
New Message Open you default E-Mail client, with a new message open.
Toggle Sound Switch playing of sound files on and off.
Delete Spam Delete all messages marked as spam.
Mark as Viewed Marks selected message as viewed.
Check First Account Checks the first e-mail account for new messages.
Stop Checking Account Stop checking for messages.

Hot-Keys:
Define up to 4 system-wide HotKeys to perform any of the above mentioned actions.
Just press the key combination you want in the edit box.

Although most key combinations are possible, be careful not to override default keys (eg. Ctrl-C) or it will be captured by PopTray and not sent the active program. Key combinations such as Ctrl-Alt-P are recommended.

Press the "delete" key to clear the assigned HotKey.

White / Black List:

The white list is used to specify friends you would want to receive messages from.  If someone is listed in the white list, any e-mail from them will not be deleted even when a rule attempts to delete the message.

The black list is e-mail address that you do not want to receive any e-mail from.  If the address is listed here any message from that address will be deleted everytime you check the server unless the option "Black List mark as Spam" is selected on the Advanced Miscellaneous Options page.

For both lists specify one e-mail address per line.

The lists also support wildcards e.g. *@spam.com


Plug-ins:

The plug-ins window will automatically list all plug-in DLLs found in the PopTray\plugins directory. Using the checkboxes, you may select which plug-ins you wish to enable. Different icons represent different types of plug-ins. You can right-click the plug-in items for plug-in specific options.


Visual Appearance:
Most UI Items Change the font for most items displayed on PopTrayU's UI. The default font is either 8 pt MS Sans Serif (XP and before) or 9 pt Segoe UI (Vista and later).
Vertical Tabs Changes the font used for the vertical tabs on the side of the main window (mail, accounts, options, etc). Because many fonts do not look good displayed vertically, you can customize the font for these tabs seperately than other UI elements. Default: MS Sans Serif 8pt.
Message List Change the font as well as foreground (pencil icon) and background colors (paint can) for the list of new email messages in the main window. Many of the colors available are system UI colors, for coordination with the active Windows color scheme. The x button clears customizations to the font and colors for this item.
Theme The entire look of PopTrayU can be changed by choosing a different theme. The "..." button next to the theme dropdown can be used to load a theme from a file. Any Delphi Visual Style theme (*.vsf) may be used, including ones from third party sources.
Toolbar Color Scheme If you are using a (third party) dark windows theme, you should enable the "twilight" scheme. This scheme changes the highlight color for toolbar buttons, and uses an alternate version of some images that will look better on a dark background (for example, images may use white instead of black as a foreground color). If you are using the standard Aero theme or another light colored windows theme, the "Normal" color scheme should be selected.