// MailFaces Option File
//
// This file contains the options that are needed to run
// the MailFaces application. For more information, refer to:
//    http://members.cruzio.com/~jthomas/mailfaces  
// and select the "Options" index item. 
//
// Either C++ style comments or 
/*        C style comments can be used */
// The "\" (BackSlash) is the escape character.
//-----------------------------------------------------------------------------
// faces.opt Syntax
//
// The 1st value is the keyword that the MailFaces program needs.
// The 2nd value is what is returned to the MailFaces program.
// The value should be enclosed in qoutes if there are any blanks or non alphamumeric
//   characters.  
//
// If the value includes "\" then it must be coded as "\\"
//
// The case of the "keyword" is unimportant, "Version", "version", VerSion" are equivalent.
// however, upper/lower case is often important in the value. 
//----------------------------------------------------------------------------
//
// Version for Option File
Version         "2.1"

// Debug option - set to "true" or "false"   (lower case)
Debug    false
//  Specify DebugFile if you want debug info to also be written to a file.
DebugFile       debug.txt

// LOG option
// Set the Log option to true to create a log file that documents 
// the major actions of mailfaces - read mail - select icons - delete mail  
Log             true
LogFile         faces.log    

//
// The MailServer statement is used to open the mailbox on the Mail server
// MailServer Type MailHostName  MailUserid  MailPassword
// Normally you would want to at least specify type, Host, and Userid. 
// Currently Type can be "POP3"  or "IMAP"
// If the password is not specified, you will be prompted for it.
// Example:
//   Mailserver POP3 mail.netcom.com  joeuser password
// 
// You can have multiple MailServers specified.  It will startup with the 
// first one but you can then use a menu item to switch to other MailServers

//MailServer  POP3 host userid    // <<<<<<<<<<<<<< EDIT this
 
// 
// used to send SMS messages via EMail and for copy/move
// Specify the server that handles the sending out of your email.
//
//SendMailHost "mailserver.com"

// SMS (Short Message Support) 
// Specify the SMS email address of your cell phone.

//SMSEmail "5555551111@mobile.mycingular.net"
//SMSMaxLength  160


// Include is used to get aditional Options from another file
// Examples:  Include "h:\\dept\\MailFaces.opt"
//            Include "/usr/local/mail/MailFaces.opt"

//
// Group statements are used to associate a group with a list of email addresses 
// that are read from a CSV (Comma separated values) file.
// You then use a "Select group" statement to associate an Icon with 
// all mail from addresses in the group (from: or reply-to:)

//Group testGroup  ".\\test.csv"

//
// used to copy/move messages to an alternate email address
// The parameter "sendmailhost" must also be specified. 
//
//DefaultCopyAddress  "user@copy.com" 
//DefaultMoveAddress  "user@move.com"

//-----------------------------------------------------------
// SelectList
// This is a list of Select statements that is used to specify special faces 
// that are used for frequent mail visitors.  
// Parameter    Description
//    1    Select Keyword 
//    2         Name of Mail header field that is used for the match
//    3         string used to match the selected Mail header
//      or 
//    3         RE "regexp" Regular Expression used to search the selected Mail header
//    4         URL to access the image when this is a match. 
//    5-        Optional parameters 
//    
//---------------------------------------------------------------------
// Example of a Mailing List entry
//   - The "Reply-To" header is used to check for the mailing list server   
//   - Icon is a local file in MailFaces image sub directory
Select reply-to  "mailfaces@topica.com"  "file:./images/topica.gif"

// Another example of a Mailing List.  Different mailing lists use different 
// ways of coding the to/from/cc/reply-to headers so you might need to look at the 
// headers for the ones you are interested in.
// "recipient" checks both the "to" and "cc" headers  
//
Select recipient  "santa-cruz-bikes@"    "file:./images/mtnbike.gif"

// Icons for Yahoogroups and Topica - well known mailing list servers
Select to "yahoogroups.com"     "file:./images/yahoogroups.gif"
Select to "topica.com"          "file:./images/topica.gif"
// 
// If there is a LIST-SUBSCRIBE: header it is probably a mailing list
// The empty search string "" will match any non null LIST-SUBSCRIBE header

Select list-subscribe  ""  "file:./images/mailinglist.gif"   

// Use "PICONDB" as the image If you want to select mailing list mail 
// so it will not be treated as SPAM but still cause it to 
// get an image based on the FROM: or REPLY-TO headers
Select sender "opera.com"  "PICONDB"

// Example of an icon for a user pointing to something on the web and a local sound file.
Select from     "jthomas@cruzio.com" "http://members.cruzio.com/~jthomas/picon.gif" "file:./images/ding.au"

// Example of using a regular expression 
//   - Because "." has special meaning in a regular expression
//     it is escaped with a "\" which also has to be escaped.
//  Refer to the MailFaces website for additional information on Regular expressions.
//Select from    RE "joe@.*\\.example\\.net"     "file:./images/friends.gif"

// Example of how you might setup an entry for a specifc domain
Select sender  "almaden.ibm.com"     "file:./images/work.gif"

// Example of how you might setup an entry for one of your friends or fellow workers
// where you want to have a short extract of the email sent to your cellphone via SMS.
// If your cellphone can access some other email account then you can also specify 
// with the copy operand that you want the entire email copied to that account.
Select sender  "myfriend@mycompany.com" "file:./images/friends.gif" SMS "copy(me@palm.com)" 

// Example of using the Group file to select an icon for everyone in an address book list
// "testGroup must have been defined earlier in a Group statement.
//Select group testGroup    "file:./images/friends.gif" 

// Some more examples (Unix administrative mail)
Select from  "postmaster@"  "file:./images/postmaster.gif"
Select from  "daemon@"      "file:./images/daemon.gif"
Select from  "root@"        "file:./images/root.gif"


// An example of pointing to a file on your local file system
// -Windows - Modify as required 
//Select from  "@example.com"  "file:/d:/my/images/example.gif"
// -Unix - Modify as required 
//Select from  "@example.com"  "file:/u/joeuser/images/example.gif"

//---------------------------------------------------------------------
// If no match is found in the SelectList then the Kill Select list is searched
// If 3rd argument is "AutoDelete" , anything that matches will be automatically deleted.
// Make sure your matching expression is accurate!
// You should be sure to specify the LOG option so that deletions will be recorded.
//
// If AutoDelete is not specified, than all mail that matches a KillSelect statement 
// will be associated with the KillImageURL and can be selected and deleted 
// by clicking on the image and selecting the delete option to delete the mail
// directly from the server.
// 
//  Some of these examples use Regular Expressions.
//   - Because "." has special meaning in a regular expression
//     it is escaped with a "\" which also has to be escaped.
//
//--------------------------------------------------------------------------

// Default icon used for SPAM   
KillImageURL         "file:./images/spam.gif"

//  The following is an example of the use of AutoDelete
//KillSelect from    "emerald@earthstar.com"   AutoDelete

//  The following is an example of parsing the subject line 
//  with a Regular Expression to recognize SPAM
KillSelect subject  RE "FREE|MONEY" 

// SPAM EMail often arrives with no or invalid From: header
// So MailFaces converts Mail without a From header to " from: -@-"
// Partial from headers result in -@host or name@- 
KillSelect from   RE  "@-|-@"

// SPAM is often not addressed directly to the recipiant
// So "not recipient" can be used to select mail  where the specified address is 
// not found in any of the to: or cc: headers.
// Warning:  This is also true of mailingList and bcc: email
//           so you must first have select statements to handle your mailing lists
//           and anyone that typically sends you bcc messages. 

//KillSelect not recipient "myuserid@mysystem.com"  // <<<---- fill in your email address and uncomment it

//
// one of the MailFaces users has contributed KillSelect statement based 
// on a list used by MicroSoft Outlook.  You can optionally include that list here
// include   nospam.opt

//---------------------------------------------------------------------
// If no match is found in the list of Select or KillSelect statements 
// then the PIcon Database is searched
//
// PIconDB specifies the URL of the PIcon database search program and
//         the names of the Icon collections to be searched.
//         
// PIconDBDomainOnly true tells it to only search for Domain names 
//  in the PIconDB and in the cache.  (Big performance benefit)
//      One would still specify "users+domains" for the cs.indiana.edu server. 
//---------------------------------------------------------------------
PIconDB           "http://www.cs.indiana.edu:800/piconsearch" "users+domains"
PIconDBDomainOnly true
//-----------------
// Example: To search for userid and domain name using 2 different servers
//  PIconDB     "http://www.dilbert.com/cgi-bin/piconsearch.pl" "local"
//  PIconDB  "http://www.cs.indiana.edu:800/piconsearch" "users+domains"
//  PIconDBDomainOnly false
//-----------------
// Example: To use an http Proxy to get to PIcon Database
//  PIconDB "http://www.cs.indiana.edu:800/piconsearch" "users+domains" PROXY gateway.com 3128
//
//-----------------------------------------------------------------
// The SelectAfter statements are used after searching the PICON database 
// and still not finding a hit
//-----------------------------------------------------------------
//SelectAfter from  "@dummy.net"  "file:./images/dummy.gif" 
//-----------------------------------------------------------------
// PIconDefer statements are used to defer the use of PiconDB icons until after it 
// checks the SelectAfter statements for more specific icons.
//-----------------------------------------------------------------
//PIconDefer "de"
//-----------------------------------------------------------------
// PIconIgnore statements are used to ignore specific PiconDB icons
//-----------------------------------------------------------------
//PIconIgnore "net"

//----------------------------------------------------------------
// BuildImageURL is the URL to a background image used when 
// neither the SelectList or PIcon database gets a match and instead of using
// the DefaultImage, we want to build a special unique image from a 
// background image and the From header.  If not specified, Then use DefaultImageURL 
//------------------------------------------------------------------
//BuildImageURL "file:./images/blank.gif"

//----------------------------------------------------------------
// DefaultImageURL is the URL used when neither the SelectList or PIcon database gets a match
//------------------------------------------------------------------

DefaultImageURL "file:./images/q_mark.gif"  

//---------------------------------------------------------------
// NoMailURL is the URL used when there is No Mail in the mailbox
//---------------------------------------------------------------
NoMailURL "file:./images/nomail.gif"  

// Support for Default Audio file (.au files only)  
//     Audio for a specific person can be specified as the 5th parm on the Select statement
AudioSupport   true
DefaultAudioURL "file:./images/chirp.au"

// Other Misc Options
ShowMaxPIcons   10
ShowMinPIcons  4

// How often to access the Mail Server and check for new Mail
DelayTime  120    // Check the mailbox every N seconds

// A longer time can be be specified and a menu item will allow you to switch between
// a short time and a long time (perhaps when you are disconnected or away from 
// your computer for a long time) 
DelayTimeLong   3600   

// Turn on the Status Message that gives some information on what is happening.
StatusMsg  true

// CacheDirectory
// This Specifies the name of the directory that is used to cache the images.
// In this case, "cache" will be a sub-directory of the current directory. 
// The CacheExpire option will control when Cache entries are deleted (using Menu)
CacheDirectory  "cache"   
CacheExpire  30  // delete if not used for N days 

// Message size Limits
//  Messages larger than MaxReadMsgSize will not have the message 
//  read from the server.  This lets MailFaces process faster.
//  MaxMsgSize is the largest message size that will be saved so 
//  it can be displayed by MailFaces using a dialog box
MaxMsgSize      8000 
MaxReadMsgSize  20000

// URL for MailFaces Help info
HelpURL    "http://members.cruzio.com/~jthomas/mailfaces"

//
// End of Options