This is for version 4.44 of the Pine client. It should be basically the same for any recent version.

• install and configure POPFile and create your buckets.

• Change the Separator Character (2nd item in configuration) to something other than a colon. I chose _ (an underscore), which isn't in my remote username. If you have one, try dash. If you have both, you'll have to experiment.

• Because pine can filter on a header, you can set 'Subject Modification' on your buckets to 'Off'.

• Open up your pinerc file in an editor and find the 'incoming-folders' field. Set it to (or add, if you already have one):

  "POPFILE" {127.0.0.1/pop3/user=<user>_<host>}INBOX

• Replace user and host as per the standard POPFile documentation. If you didn't use underscore as your separator, change that appropriately as well. Save it and restart pine.

• This will create a new inbox folder named “POPFILE” that will retrieve your email.

• From the pine main menu, go to Setup/Rules. At the Type of Rule prompt, hit 'F' for filters.

• Type 'A' to add a filter.

• Change the nickname to 'POPFile-<bucket name>' or whatever makes you comfortable.

• Leave the Folder Type at 'Specific' but change the Folder List value to be 'POPFILE' (or whatever you named the inbox folder to be in your pinerc file)

• Move the cursor down to one of the preset patterns (doesn't matter which) and type 'X' to add an extended header. At the name prompt enter 'X-Text-Classification'.

• Enter the name of your POPFile bucket as the value.

• Move to the Filter Action area. Leave the selection at 'Move' but change the Folder List value to be the bucket name (eg 'Folder List = spam')

• Move down to the end of the options to the move-only-if-not-deleted option and hit enter to set it to true.

• 'E' to Exit the filter setup. You'll be prompted to create the new folder (if it's new) and add it to the Incoming folders. Reply yes to both. Set the nickname to be the bucket name (or whatever you like).

• Repeat steps for each POPFile bucket.

• Enter 'E' to exit setup. Reply Yes to commiting changes.

• If you hit 'L' from the main menu to list folders and go to Incoming Folders you should now see your POPFile folder as well as a folder for each of your buckets.

That should be it. As you train POPFile, Pine will filter your mail whenever you open the POPFILE folder.

Note: For those folders that you want to filter to but you don't want to navigate through by default (I have 'spam' and 'virus'), create the folder, but don't add it to Incoming folders. If you already have, you can edit the list in your pinerc file. This lets you tab through the folders you actually want to read, and go to the bad folders through the Local Folders interface.