Welcome to POPFile v1.0.1

POPFile is an email classification tool with a Naive Bayes classifier, POP3, SMTP, NNTP proxies and IMAP filter and a web interface. It runs on most platforms and with most email clients.

This version is a bug fix and minor feature release. It's also the first release to have been built by Brian Smith

WHAT'S CHANGED SINCE v1.0.0

1. Bug fixes

When POPFile starts up it no longer complains about a missing IMAP file if IMAP has not been installed.

Fixed a bug in the IMAP module that allowed for unintentional reclassification to the unclassified bucket.

Fixed a bug that causes segmentation faults when displaying messages which have very long To, Cc or From headers in the POPFile UI.

Fixed a bug that causes a few warnings during the corpus upgrade process.

Add code to check for unexpected NULL characters in email messages (to avoid SQLite problems).

2. POPFile improvements

POPFile's Brazilian Portuguese language file has been renamed. The new name does not include any spaces.

The simplified and traditional Chinese language translations have been updated.

POPFile's log file now includes entries showing when POPFile starts up and shuts down. This makes it easier to read the log file.

The startup messages in the log file have been made easier to read by splitting the long entries into shorter lines.

The IMAP module now issues a log message when it fails to connect to the server.

Deletion of messages from the message history has been made faster.

3. Installer improvements

When upgrading an existing installation the installer now recommends upgrading the existing SSL support files.

The installer and all of the NSIS-based programs have been built using the latest NSIS compiler and newer versions of the plugins used to download files from the internet. These NSIS-related improvements should reduce the number of false alarms from various anti-virus packages.

The latest version of the SQLite command-line utility is now included.

4. UI improvements

The links to the wiki have been improved.

5. Other changes

The (outdated) manual is no longer included in the download. All documentation for POPFile is online and can be found at http://getpopfile.org/docs/

WHERE TO DOWNLOAD

  http://getpopfile.org/download/

GETTING STARTED WITH POPFILE

An introduction to installing and using POPFile can be found in the QuickStart guide:

  http://getpopfile.org/docs/QuickStart

SSL SUPPORT IN WINDOWS

SSL Support is offered as one of the optional components by the installer. If the SSL Support option is selected the installer will download the necessary files during installation.

If SSL support is not selected when installing (or upgrading) POPFile or if the installer was unable to download all of the SSL files then POPFile's “Add/Remove Programs” entry can be used to add SSL support to an existing installation.

I AM USING THE CROSS PLATFORM VERSION

POPFile requires a number of Perl modules that are available from CPAN. You will need:

 Date::Parse
 HTML::Template
 HTML::Tagset
 DBD::SQLite2
 DBI
 TimeDate

You can install all the required POPFile modules by getting the Bundle::POPFile bundle from CPAN.

Please refer to the installation instructions on the POPFile wiki:

 http://getpopfile.org/docs/HowTos:CrossPlatformInstall

Japanese users may need to install some extra programs and Perl modules, depending upon which Nihongo parser (wakachi-gaki program) they wish to use. For more information about how to install them, see the POPFile wiki:

 http://getpopfile.org/docs/JP:HowTos:CrossPlatformInstall

CROSS PLATFORM VERSION KNOWN ISSUES

The current version of SQLite (v3.x) is not compatible with POPFile. You must use DBD:SQLite2 to access the database.

Users of SSL on non-Windows platforms should NOT use IO::Socket::SSL v0.97 or v0.99. They are known to be incompatible with POPFile; v1.13 is the most recent release of IO::Socket::SSL that works correctly.

WINDOWS KNOWN ISSUES

1. THE TRAYICON ON WINDOWS CAN CAUSE POPFILE TO FREEZE. With certain setups, if you attempt to view the trayicon's tooltip or hover your cursor over it while checking or downloading mail POPFile may freeze. The exact cause is still unknown but it may be related to some video drivers. If this problem affects you turn off the trayicon.

Due to this issue, we suggest users of the IMAP module disable the trayicon since a freeze may go unnoticed more easily than when using a mail client to make POP3 connections.

2. ON WINDOWS I WANT TO CHECK MULTIPLE EMAIL ACCOUNTS SIMULTANEOUSLY. Because the time taken to start a new process on Windows is long under Perl there is an optimization for Windows that is present by default: when a new connection is made between your email program and POPFile, POPFile handles it in the 'parent' process. This means the connect happens fast and mail starts downloading very quickly, but it means that you can only download messages from one server at a time (up to 6 other connections will be queued up and dealt with in the order they arrive) and the UI is unavailable while downloading email.

You can turn this behavior off (and get simultaneous UI/email access and as many email connections as you like) on the Configuration panel in the UI by making sure that “Allow concurrent POP3 connections:” is Yes, or by specifying –set pop3_force_fork=1 on the command line.

The default behaviour (no concurrent POP3 connections) can cause email clients to time out if several accounts are being checked (because POPFile only handles one account at a time it can take a while to process all of the accounts).

If SSL support is being used then the default setting (no concurrent POP3 connections) _MUST_ be used otherwise POPFile crashes.

v1.0.0 RELEASE NOTES

If you are upgrading from pre-v1.0.0 please read the v1.0.0 release notes for much more information:

 http://getpopfile.org/docs/ReleaseNotes:1.0.0

DONATIONS

Thank you to everyone who has clicked the Donate! button and donated their hard earned cash to me in support of POPFile. Thank you also to the people who have contributed their time through patches, feature requests, bug reports, user support and translations.

 http://sourceforge.net/forum/forum.php?forum_id=213876

THANKS

Big thanks to all who've contributed to POPFile.

John.