imapfilter/imapfilter/sample.imapfilterrc

##########################
# Accounts and mailboxes #
##########################
#
# Each account has a number of folders/mailboxes which are grouped under
# an alias name. Folders belong to the last preceding account. A mailbox
# can belong to many mailbox groups.
#

#
# Connects to "imap1.mail.server" at port 143, as "user1" and
# using password "secret1".
#
# Mailboxes that exist at "imap1.mail.server" include: "INBOX", "woody",
# "linux-mailist", etc. and are grouped in various ways.
#
account user1:secret1@imap1.mail.server:143
  folder inbox1 INBOX
  folder friends Woody,Buzz
  folder bsd bsd-mailist
  folder linux linux-mailist
  folder lists linux-mailist,bsd-mailist
  folder all INBOX,woody,buzz,linux-mailist,bsd-mailist

#
# Another account and it's folder settings.
#
account user2:secret2@imap2.mail.server
  folder inbox2 INBOX
  folder games nethack,koules


###########
# Filters #
###########
#
# Filters are completely independent from any account or folder settings.
# The mask command may be ommited. If no masks are declared inside
# a filter entry, then all messages are matched.
#

#
# A possible anti-spam filter to get rid of unwanted messages.
#
# The "or" flag in the arguments of the filter command makes the
# filter masks work like this (in pseudocode):
#   if (from ... )
#     or if (from ...)
#     or if (subject ...)
#   then delete
#
filter spam or
  mask from marketing@company.junk
  mask from advertising@annoying.promotion
  mask subject new great products
action delete

#
# Another filter useful for sorting of mail.
#
# This one moves messages with the specified "sender" header to
# the mailbox bsd-mailist.
#
# When no "or" or "and" flag is specified for a filter the default
# "and" is used.
#
filter bsdlist or
  header sender bsd-mailist@mailist.bsd
action move bsd-mailist

#
# Messages can be copied to a folder, eg. for archive purposes.
#
# This filter copies all messages with the "[patch]" word in
# the subject header and smaller that 50000 bytes, to a mailbox
# named "patches" that may or may not exist (in the latter case
# it will be automatically created).
#
filter patch and
  subject [patch]
  smaller 50000
action copy patches

#
# One can also display some of the headers of messages that match
# a filter.
#
# This filter prints the "From", "Subject" and "Date" headers of 
# recent, unread messages, that come from "tux@penguin.land" or
# "beastie@daemon.land" but not with a subject containing the
# phrase "all work and no play".
#
# Note that the "recent and unseen" functionality can also be
# accomplished with "new" or even "not old".
#
filter display
  recent
  unseen
  from tux@penguin.land
  or from beastie@daemon.land
  not subject all work and no play
action list from,subject,date


########
# Jobs #
########
#
# Last, there is the definition of the jobs where user combines
# folders and filters _already_ defined, and specifies which filters
# should be applied to which folders.
#

job spam,display inbox1,inbox2
job patch lists
job bsdlist inbox1
1	lefcha	1.7	##########################
2			# Accounts and mailboxes #
3			##########################
4	lefcha	1.8	#
5			# Each account has a number of folders/mailboxes which are grouped under
6			# an alias name. Folders belong to the last preceding account. A mailbox
7			# can belong to many mailbox groups.
8			#
9	lefcha	1.7
10			#
11			# Connects to "imap1.mail.server" at port 143, as "user1" and
12			# using password "secret1".
13			#
14	lefcha	1.8	# Mailboxes that exist at "imap1.mail.server" include: "INBOX", "woody",
15			# "linux-mailist", etc. and are grouped in various ways.
16			#
17	lefcha	1.7	account user1:secret1@imap1.mail.server:143
18	lefcha	1.8	folder inbox1 INBOX
19			folder friends Woody,Buzz
20			folder bsd bsd-mailist
21			folder linux linux-mailist
22			folder lists linux-mailist,bsd-mailist
23			folder all INBOX,woody,buzz,linux-mailist,bsd-mailist
24	lefcha	1.7
25			#
26			# Another account and it's folder settings.
27			#
28			account user2:secret2@imap2.mail.server
29	lefcha	1.8	folder inbox2 INBOX
30			folder games nethack,koules
31	lefcha	1.7
32
33			###########
34			# Filters #
35			###########
36			#
37	lefcha	1.8	# Filters are completely independent from any account or folder settings.
38			# The mask command may be ommited. If no masks are declared inside
39			# a filter entry, then all messages are matched.
40	lefcha	1.7	#
41
42			#
43			# A possible anti-spam filter to get rid of unwanted messages.
44			#
45			# The "or" flag in the arguments of the filter command makes the
46			# filter masks work like this (in pseudocode):
47			# if (from ... )
48			# or if (from ...)
49			# or if (subject ...)
50			# then delete
51			#
52			filter spam or
53	lefcha	1.8	mask from marketing@company.junk
54			mask from advertising@annoying.promotion
55			mask subject new great products
56	lefcha	1.7	action delete
57
58			#
59			# Another filter useful for sorting of mail.
60			#
61			# This one moves messages with the specified "sender" header to
62			# the mailbox bsd-mailist.
63			#
64			# When no "or" or "and" flag is specified for a filter the default
65			# "and" is used.
66			#
67			filter bsdlist or
68	lefcha	1.8	header sender bsd-mailist@mailist.bsd
69	lefcha	1.7	action move bsd-mailist
70
71			#
72			# Messages can be copied to a folder, eg. for archive purposes.
73			#
74			# This filter copies all messages with the "[patch]" word in
75			# the subject header and smaller that 50000 bytes, to a mailbox
76			# named "patches" that may or may not exist (in the latter case
77			# it will be automatically created).
78			#
79			filter patch and
80	lefcha	1.8	subject [patch]
81			smaller 50000
82	lefcha	1.7	action copy patches
83
84			#
85			# One can also display some of the headers of messages that match
86			# a filter.
87			#
88	lefcha	1.8	# This filter prints the "From", "Subject" and "Date" headers of
89	lefcha	1.7	# recent, unread messages, that come from "tux@penguin.land" or
90			# "beastie@daemon.land" but not with a subject containing the
91			# phrase "all work and no play".
92			#
93			# Note that the "recent and unseen" functionality can also be
94			# accomplished with "new" or even "not old".
95			#
96			filter display
97	lefcha	1.8	recent
98			unseen
99			from tux@penguin.land
100			or from beastie@daemon.land
101			not subject all work and no play
102	lefcha	1.7	action list from,subject,date
103
104
105			########
106			# Jobs #
107			########
108			#
109	lefcha	1.8	# Last, there is the definition of the jobs where user combines
110	lefcha	1.7	# folders and filters _already_ defined, and specifies which filters
111			# should be applied to which folders.
112			#
113	lefcha	1.8
114	lefcha	1.7	job spam,display inbox1,inbox2
115	lefcha	1.8	job patch lists
116	lefcha	1.7	job bsdlist inbox1