2002-06-20 09:40:29 +02:00
|
|
|
# Sample configuration file
|
|
|
|
# Copyright (C) 2002 John Goerzen
|
|
|
|
# <jgoerzen@complete.org>
|
|
|
|
#
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
|
|
# (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
2002-06-21 08:51:21 +02:00
|
|
|
##################################################
|
|
|
|
# General definitions
|
|
|
|
##################################################
|
|
|
|
|
2002-06-20 09:40:29 +02:00
|
|
|
[general]
|
|
|
|
|
2002-06-21 12:01:10 +02:00
|
|
|
# This specifies where offlineimap is to store its metadata.
|
2002-06-20 09:40:29 +02:00
|
|
|
# This directory will be created if it does not already exist.
|
|
|
|
|
2002-06-21 12:01:10 +02:00
|
|
|
metadata = ~/.offlineimap
|
2002-06-20 09:40:29 +02:00
|
|
|
|
|
|
|
# This variable specifies which accounts are defined. Separate them
|
|
|
|
# with commas. Account names should be alphanumeric only.
|
|
|
|
# You will need to specify one section per account below. You may
|
|
|
|
# not use "general" for an account name.
|
|
|
|
#
|
|
|
|
|
|
|
|
accounts = Test
|
|
|
|
|
2002-06-21 12:01:10 +02:00
|
|
|
# You can have offlineimap continue running indefinately, automatically
|
2002-06-21 09:25:24 +02:00
|
|
|
# syncing your mail periodically. If you want that, specify how
|
|
|
|
# frequently to do that (in minutes) here.
|
|
|
|
|
|
|
|
# autorefresh = 5
|
|
|
|
|
2002-07-03 13:01:23 +02:00
|
|
|
# Offlineimap can synchronize more the one account at a time. If you
|
|
|
|
# want to enable this feature, set the below value to something
|
|
|
|
# greater than 1. To force it to synchronize only one account at a
|
|
|
|
# time, leave it at 1.
|
|
|
|
#
|
|
|
|
|
|
|
|
maxsyncaccounts = 1
|
|
|
|
|
2002-07-12 03:58:51 +02:00
|
|
|
# You can specify one or more user interface modules for OfflineIMAP
|
|
|
|
# to use. OfflineIMAP will try the first in the list, and if it
|
|
|
|
# fails, the second, and so forth.
|
|
|
|
#
|
|
|
|
# The pre-defined options are:
|
2002-07-25 00:20:42 +02:00
|
|
|
# Tk.Blinkenlights -- A graphical interface, shows LEDs and a single log
|
|
|
|
# Tk.VerboseUI -- A graphical interface, shows logs per thread
|
2002-07-12 03:58:51 +02:00
|
|
|
# TTY.TTYUI -- a text-based (terminal) interface
|
2002-07-22 08:55:27 +02:00
|
|
|
# Noninteractive.Basic -- Noninteractive interface suitable for cronning
|
|
|
|
# Noninteractive.Quiet -- Noninteractive interface, generates no output
|
|
|
|
# except for errors.
|
2002-07-12 03:58:51 +02:00
|
|
|
#
|
|
|
|
# You can override this with a command-line option -u.
|
|
|
|
|
2002-07-25 01:13:09 +02:00
|
|
|
ui = Tk.Blinkenlights, Tk.VerboseUI, TTY.TTYUI, Noninteractive.Basic,
|
|
|
|
Noninteractive.Quiet
|
2002-07-12 03:58:51 +02:00
|
|
|
|
2002-08-08 03:57:17 +02:00
|
|
|
# If you try to synchronize messages to a read-only folder,
|
|
|
|
# OfflineIMAP will generate a warning. If you want to suppress these
|
|
|
|
# warnings, set ignore-readonly to yes. Read-only IMAP folders allow
|
|
|
|
# reading but not modification, so if you try to change messages in
|
|
|
|
# the local copy of such a folder, the IMAP server will prevent
|
|
|
|
# OfflineIMAP from propogating those changes to the IMAP server.
|
|
|
|
|
|
|
|
ignore-readonly = no
|
2002-07-12 03:58:51 +02:00
|
|
|
|
2002-08-09 23:10:38 +02:00
|
|
|
########## Advanced settings
|
|
|
|
|
|
|
|
# You can give a Python source filename here and all config file
|
|
|
|
# python snippets will be evaluated in the context of that file.
|
|
|
|
# This allows you to e.g. define helper functions in the Python
|
2002-08-09 23:25:28 +02:00
|
|
|
# source file and call them from this config file. You can find
|
|
|
|
# an example of this in the manual.
|
2002-08-09 23:10:38 +02:00
|
|
|
#
|
|
|
|
# pythonfile = ~/.offlineimap.py
|
|
|
|
#
|
|
|
|
|
2002-06-21 08:51:21 +02:00
|
|
|
##################################################
|
|
|
|
# Mailbox name recorder
|
|
|
|
##################################################
|
|
|
|
|
|
|
|
[mbnames]
|
|
|
|
|
2002-06-21 12:01:10 +02:00
|
|
|
# offlineimap can record your mailbox names in a format you specify.
|
2002-06-21 08:51:21 +02:00
|
|
|
# You can define the header, each mailbox item, the separator,
|
|
|
|
# and the footer. Here is an example for Mutt.
|
|
|
|
# If enabled is yes, all six setting must be specified, even if they
|
|
|
|
# are just the empty string "".
|
|
|
|
#
|
|
|
|
# The header, peritem, sep, and footer are all Python expressions passed
|
|
|
|
# through eval, so you can (and must) use Python quoting.
|
|
|
|
|
|
|
|
enabled = no
|
|
|
|
filename = ~/Mutt/muttrc.mailboxes
|
|
|
|
header = "mailboxes "
|
|
|
|
peritem = "+%(accountname)s/%(foldername)s"
|
|
|
|
sep = " "
|
|
|
|
footer = "\n"
|
|
|
|
|
2002-10-01 00:09:27 +02:00
|
|
|
# You can also specify a folderfilter. It will apply to the
|
|
|
|
# *translated* folder name here, and it takes TWO arguments:
|
|
|
|
# accountname and foldername. In all other ways, it will
|
|
|
|
# behave identically to the folderfilter for accounts. Please see
|
|
|
|
# that section for more information and examples.
|
|
|
|
#
|
|
|
|
# Note that this filter can be used only to further restrict mbnames
|
|
|
|
# to a subset of folders that pass the account's folderfilter.
|
|
|
|
|
2002-07-25 00:20:42 +02:00
|
|
|
##################################################
|
|
|
|
# Blinkenlights configuration
|
|
|
|
##################################################
|
|
|
|
|
|
|
|
[ui.Tk.Blinkenlights]
|
|
|
|
|
|
|
|
# Specifies the default number of lines in the log.
|
|
|
|
|
|
|
|
loglines = 5
|
|
|
|
|
2002-07-25 09:36:24 +02:00
|
|
|
# Specifies how many lines are in the scrollback log buffer.
|
|
|
|
|
|
|
|
bufferlines = 500
|
|
|
|
|
2002-07-25 00:20:42 +02:00
|
|
|
# If true, says that the log should be enabled by default.
|
|
|
|
# Otherwise, you have to click "Show Log" to enable the log.
|
|
|
|
|
|
|
|
showlog = false
|
|
|
|
|
2002-08-27 03:06:02 +02:00
|
|
|
# Sets the font information.
|
|
|
|
|
|
|
|
fontfamily = Helvetica
|
|
|
|
fontsize = 8
|
2002-07-25 09:36:24 +02:00
|
|
|
|
2002-06-21 08:51:21 +02:00
|
|
|
##################################################
|
|
|
|
# Accounts
|
|
|
|
##################################################
|
|
|
|
|
|
|
|
# This is an account definition clause. You'll have one of these
|
|
|
|
# for each account listed in general/accounts above.
|
2002-06-20 09:40:29 +02:00
|
|
|
|
|
|
|
[Test]
|
2002-07-09 04:32:35 +02:00
|
|
|
|
|
|
|
########## Basic settings
|
|
|
|
|
|
|
|
# Specify local repository. Your IMAP folders will be synchronized
|
|
|
|
# to maildirs created under this path. OfflineIMAP will create the
|
|
|
|
# maildirs for you as needed.
|
|
|
|
|
|
|
|
localfolders = ~/Test
|
|
|
|
|
2002-06-20 09:40:29 +02:00
|
|
|
# Specify the remote hostname.
|
2002-06-21 08:51:21 +02:00
|
|
|
remotehost = examplehost
|
2002-06-20 09:40:29 +02:00
|
|
|
|
|
|
|
# Whether or not to use SSL.
|
|
|
|
ssl = yes
|
|
|
|
|
|
|
|
# Specify the port. If not specified, use a default port.
|
|
|
|
# remoteport = 993
|
|
|
|
|
|
|
|
# Specify the remote user name.
|
2002-07-03 13:01:23 +02:00
|
|
|
remoteuser = username
|
2002-06-20 09:40:29 +02:00
|
|
|
|
2002-07-05 07:47:52 +02:00
|
|
|
# There are three ways to specify the password for the remote IMAP
|
|
|
|
# server:
|
|
|
|
#
|
|
|
|
# 1. No password at all specified in the config file. You will
|
|
|
|
# be prompted for the password when OfflineIMAP starts.
|
|
|
|
#
|
|
|
|
# 2. The remote password stored in this file with the remotepass
|
|
|
|
# option. Example:
|
|
|
|
#
|
|
|
|
# remotepass = mypassword
|
|
|
|
#
|
|
|
|
# 3. The remote password stored as a single line in an external
|
|
|
|
# file, which is referenced by the remotefile option. Example:
|
|
|
|
#
|
|
|
|
# remotepassfile = ~/Password.IMAP.Account1
|
2002-07-05 08:36:34 +02:00
|
|
|
#
|
|
|
|
# 4. With a preauth tunnel. With this method, you invoke an external
|
|
|
|
# program that is guaranteed *NOT* to ask for a password, but rather
|
|
|
|
# to read from stdin and write to stdout an IMAP procotol stream
|
|
|
|
# that begins life in the PREAUTH state. When you use a tunnel,
|
|
|
|
# you do NOT specify a user or password (if you do, they'll be
|
|
|
|
# ignored.) Instead, you specify a preauthtunnel, as this
|
|
|
|
# example illustrates for Courier IMAP on Debian:
|
|
|
|
#
|
|
|
|
# preauthtunnel = ssh -q imaphost '/usr/bin/imapd ./Maildir'
|
|
|
|
#
|
2002-06-20 09:40:29 +02:00
|
|
|
|
2002-07-09 04:32:35 +02:00
|
|
|
########## Advanced settings
|
|
|
|
|
|
|
|
|
2002-07-05 13:46:55 +02:00
|
|
|
# Some IMAP servers need a "reference" which often refers to the
|
|
|
|
# "folder root". This is most commonly needed with UW IMAP, where
|
|
|
|
# you might need to specify the directory in which your mail is
|
|
|
|
# stored. Most users will not need this.
|
|
|
|
#
|
|
|
|
# reference = Mail
|
|
|
|
|
2002-06-21 08:51:21 +02:00
|
|
|
# You can specify a folder translator. This must be a eval-able
|
|
|
|
# Python expression that takes a foldername arg and returns the new
|
2002-07-05 07:47:52 +02:00
|
|
|
# value. I suggest a lambda. This example below will remove "INBOX." from
|
2002-06-21 08:51:21 +02:00
|
|
|
# the leading edge of folders (great for Courier IMAP users)
|
2002-07-05 07:47:52 +02:00
|
|
|
#
|
|
|
|
# WARNING: you MUST construct this such that it NEVER returns
|
|
|
|
# the same value for two folders, UNLESS the second values are
|
|
|
|
# filtered out by folderfilter below. Failure to follow this rule
|
|
|
|
# will result in undefined behavior
|
|
|
|
#
|
2002-06-21 08:51:21 +02:00
|
|
|
# nametrans = lambda foldername: re.sub('^INBOX.', '', foldername)
|
2002-07-03 13:01:23 +02:00
|
|
|
|
2002-07-04 08:10:51 +02:00
|
|
|
# You can specify which folders to sync. You can do it several ways.
|
|
|
|
# I'll provide some examples. The folderfilter operates on the
|
|
|
|
# *UNTRANSLATED* name, if you specify nametrans. It should return
|
|
|
|
# true if the folder is to be included; false otherwise.
|
|
|
|
#
|
|
|
|
# Example 1: synchronizing only INBOX and Sent.
|
|
|
|
#
|
|
|
|
# folderfilter = lambda foldername: foldername in ['INBOX', 'Sent']
|
|
|
|
#
|
|
|
|
# Example 2: synchronizing everything except Trash.
|
|
|
|
#
|
|
|
|
# folderfilter = lambda foldername: foldername not in ['Trash']
|
|
|
|
#
|
|
|
|
# Example 3: Using a regular expression to exclude Trash and all folders
|
|
|
|
# containing the characters "Del".
|
|
|
|
#
|
2002-07-09 04:23:47 +02:00
|
|
|
# folderfilter = lambda foldername: not re.search('(^Trash$|Del)', foldername)
|
2002-07-04 08:10:51 +02:00
|
|
|
#
|
|
|
|
# If folderfilter is not specified, ALL remote folders will be
|
|
|
|
# synchronized.
|
|
|
|
#
|
|
|
|
# You can span multiple lines by indenting the others. (Use backslashes
|
|
|
|
# at the end when required by Python syntax) For instance:
|
|
|
|
#
|
|
|
|
# folderfilter = lambda foldername: foldername in
|
|
|
|
# ['INBOX', 'Sent Mail', 'Deleted Items',
|
|
|
|
# 'Received']
|
|
|
|
#
|
|
|
|
# FYI, you could also include every folder with:
|
|
|
|
#
|
|
|
|
# folderfilter = lambda foldername: 1
|
|
|
|
#
|
|
|
|
# And exclude every folder with:
|
|
|
|
#
|
|
|
|
# folderfilter = lambda foldername: 0
|
|
|
|
|
2002-07-09 04:32:35 +02:00
|
|
|
# You can specify folderincludes to include additional folders.
|
|
|
|
# It should return a Python list. This might be used to include a
|
|
|
|
# folder that was excluded by your folderfilter rule, to include a
|
|
|
|
# folder that your server does not specify with its LIST option, or
|
|
|
|
# to include a folder that is outside your basic reference. Some examples:
|
|
|
|
#
|
|
|
|
# To include debian.user and debian.personal:
|
|
|
|
#
|
|
|
|
# folderincludes = ['debian.user', 'debian.personal']
|
|
|
|
#
|
|
|
|
# To include your INBOX (UW IMAPd users will find this useful if they
|
|
|
|
# specify a reference):
|
|
|
|
#
|
|
|
|
# folderincludes = ['INBOX']
|
|
|
|
#
|
|
|
|
# To specify a long list:
|
|
|
|
#
|
|
|
|
# folderincludes = ['box1', 'box2', 'box3', 'box4',
|
|
|
|
# 'box5', 'box6']
|
|
|
|
|
2002-08-09 23:10:38 +02:00
|
|
|
# You can specify foldersort to determine how folders are sorted.
|
|
|
|
# This affects order of synchronization and mbnames. The expression
|
2002-08-09 23:25:28 +02:00
|
|
|
# should return -1, 0, or 1, as the default Python cmp() does. The
|
|
|
|
# two arguments, x and y, are strings representing the names of the folders
|
|
|
|
# to be sorted. The sorting is applied *AFTER* nametrans, if any.
|
2002-08-09 23:10:38 +02:00
|
|
|
#
|
|
|
|
# To reverse the sort:
|
|
|
|
#
|
|
|
|
# foldersort = lambda x, y: -cmp(x, y)
|
|
|
|
|
2002-07-03 13:01:23 +02:00
|
|
|
# OfflineIMAP can use multiple connections to the server in order
|
|
|
|
# to perform multiple synchronization actions simultaneously.
|
|
|
|
# This may place a higher burden on the server. In most cases,
|
|
|
|
# setting this value to 2 or 3 will speed up the sync, but in some
|
|
|
|
# cases, it may slow things down. The safe answer is 1. You should
|
|
|
|
# probably never set it to a value more than 5.
|
|
|
|
|
|
|
|
maxconnections = 1
|
|
|
|
|
2002-07-10 13:18:07 +02:00
|
|
|
# OfflineIMAP normally closes IMAP server connections between refreshes if
|
|
|
|
# the global option autorefresh is specified. If you wish it to keep the
|
|
|
|
# connection open, set this to true. If not specified, the default is
|
|
|
|
# false. Keeping the connection open means a faster sync start the
|
|
|
|
# next time and may use fewer server resources on connection, but uses
|
|
|
|
# more server memory. This setting has no effect if autorefresh is not set.
|
|
|
|
|
|
|
|
holdconnectionopen = no
|
|
|
|
|
|
|
|
# If you want to have "keepalives" sent while waiting between syncs,
|
|
|
|
# specify the amount of time IN SECONDS between keepalives here. Note that
|
|
|
|
# sometimes more than this amount of time might pass, so don't make it
|
|
|
|
# tight. This setting has no effect if autorefresh and holdconnectionopen
|
|
|
|
# are not both set.
|
|
|
|
|
|
|
|
# keepalive = 60
|
2002-08-08 04:40:18 +02:00
|
|
|
|
|
|
|
# You can specify the "path separator character" used for your Maildir
|
|
|
|
# folders. This is inserted in-between the components of the tree.
|
|
|
|
# It defaults to ".". If you want your Maildir folders to be nested,
|
|
|
|
# set it to "/".
|
|
|
|
|
|
|
|
sep = .
|
2002-11-12 22:36:34 +01:00
|
|
|
|
|
|
|
# Normally, OfflineIMAP will expunge deleted messages from the server.
|
|
|
|
# You can disable that if you wish. This means that OfflineIMAP will
|
|
|
|
# mark them deleted on the server, but not actually delete them.
|
|
|
|
# You must use some other IMAP client to delete them if you use this
|
|
|
|
# setting; otherwise, the messgaes will just pile up there forever.
|
|
|
|
# Therefore, this setting is definately NOT recommended.
|
|
|
|
#
|
|
|
|
# expunge = no
|