UNIX tools
Japanese / English
- software to completely automatically distribute email in folders.
- intended for people using IMAP. Like procmail, it operates on the server-side.
- because it is a bayesian filter that learns previous classifications, defining rules is unnecessary.
- special action to correct a classification mistake is not necessary. Just move the email to the right folder using your email application.
- The object of classification's folder is OK with any number of elements.
Download †
imap-bayes-0.2.tar.gz
* this software is a beta release. In the worst case, there's a possibility of arriving email disappearing because of a bug. Please handle with adequate care.
Operating requirements †
Email environment is:
- UNIX OS（currently only verified with FreeBSD 4.10).
- using qmail. *1
- a mailbox in Maildir format（as described later).
- receiving email with IMAP.
Unless the mentioned conditions have been met, you cannot use it. In addition,
is necessary, so please install.
Simple instructions †
Extract files from the downloaded file, and type the following as root:
# ruby install.rb --without-kakasi
Installation has finished. The rest is the configuration for each user (or mailbox). Open ~/.qmail and check if the following line exists:
./Maildir/
If the directory name is different, replace it in the following explanation. If the line doesn't finish with "/" (slash), you cannot use imap-bayes because your mailbox is not in Maildir format. Type:
$ cd
$ imap-bayes --init ./Maildir
$ imap-bayes --learn ./Maildir
and the first learning starts. It may take several minutes or more. (Later, learning automatically starts everyday.)
Finally, replace the following line in ~/.qmail:
./Maildir/
to
| preline /usr/local/bin/imap-bayes ./Maildir
Mail to yourself for trial. Is your mail delivered (to one of the folders) ?
Detailed instructions †
install.rb †
# ruby install.rb [options]
The following options are available.
| option | default | description |
| --prefix=PATH | /usr/local | Install here. |
| --ruby=PATH | ruby used for install.rb | ruby used for imap-bayes. |
| --kakasi=PATH | automatic | Path to kakasi. |
| --without-kakasi | | Don't use kakasi. Specify this if you don't receive mails written in Japanese. |
$ imap-bayes [command] Maildir
Specify a mailbox in Maildir format for Maildir. command is one of the following.
| command | effect |
| --init | Initialize Maildir/imap-bayes.conf. |
| --learn | Learn difference from the last learning. Automatically executed everyday. |
| --relearn | Clear all learning data and relearn. |
| --analyze | Output the analysis of the last mail as CSV format. |
| --test | Experimentally classify randomly selected mails and evaluate the precision. No effect on the mailbox. |
| (none) | Classify the mail from the standard input to the mailbox. Usually called via qmail. |
A configuration file written with "name=value" format.
| name | description |
| IGNORES | Specify folders (split with ":") to be excluded on filtering. English and Japanese (EUC) folder names are avaliable. Folder names with other languages are currently not supported. Use "." to specify subfolders (eg. "Private.Family"). |
| LIMIT | For each folder, latest LIMIT mails are used for learning. |
Contact †
Contact me with the following comment area.
- Thank you for finishing the page, and for imap-bayes of course. -- MouradDeClerck?
- Aloha! upx -- Gundoshlg?
Change Log †
- Ver.0.2
- Licence changed due to licence conflict.
License †
GPL Ver.2.
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
