]> code.delx.au - offlineimap/blobdiff - offlineimap.conf
Bump version number
[offlineimap] / offlineimap.conf
index 80d662f8afcc1da7f2fbb7272617aa66a1087dd5..9263df7475df2adbeff1e3d663ee9aafb4bbfbd0 100644 (file)
@@ -51,18 +51,18 @@ maxsyncaccounts = 1
 # fails, the second, and so forth.
 #
 # The pre-defined options are:
-# Tk.Blinkenlights -- A graphical interface, shows LEDs and a single log
-# Tk.VerboseUI -- A graphical interface, shows logs per thread
 # Curses.Blinkenlights -- A text-based (terminal) interface similar to
 # Tk.Blinkenlights
 # TTY.TTYUI -- a text-based (terminal) interface
 # Noninteractive.Basic -- Noninteractive interface suitable for cronning
 # Noninteractive.Quiet -- Noninteractive interface, generates no output
 #                         except for errors.
+# Machine.MachineUI -- Interactive interface suitable for machine
+#                      parsing.
 #
 # You can override this with a command-line option -u.
 
-ui = Tk.Blinkenlights, Tk.VerboseUI, Curses.Blinkenlights, TTY.TTYUI,
+ui = Curses.Blinkenlights, TTY.TTYUI,
      Noninteractive.Basic, Noninteractive.Quiet
 
 # If you try to synchronize messages to a read-only folder,
@@ -85,6 +85,19 @@ ignore-readonly = no
 # pythonfile = ~/.offlineimap.py
 #
 
+# By default, OfflineIMAP will not exit due to a network error until
+# the operating system returns an error code.  Operating systems can sometimes
+# take forever to notice this.  Here you can activate a timeout on the
+# socket.  This timeout applies to individual socket reads and writes,
+# not to an overall sync operation.  You could perfectly well have a 30s
+# timeout here and your sync still take minutes.
+#
+# Values in the 30-120 second range are reasonable.
+#
+# The default is to have no timeout beyond the OS.  Times are given in seconds.
+#
+# socktimeout = 60
+
 ##################################################
 # Mailbox name recorder
 ##################################################
@@ -116,29 +129,10 @@ footer = "\n"
 # Note that this filter can be used only to further restrict mbnames
 # to a subset of folders that pass the account's folderfilter.
 
-##################################################
-# Blinkenlights configuration
-##################################################
-
-[ui.Tk.Blinkenlights]
-
-# Specifies the default number of lines in the log.
-
-loglines = 5
-
-# Specifies how many lines are in the scrollback log buffer.
+[ui.Curses.Blinkenlights]
+# Character used to indicate thread status.
 
-bufferlines = 500
-
-# If true, says that the log should be enabled by default.
-# Otherwise, you have to click "Show Log" to enable the log.
-
-showlog = false
-
-# Sets the font information.
-
-fontfamily = Helvetica
-fontsize = 8
+statuschar = .
 
 ##################################################
 # Accounts
@@ -165,6 +159,16 @@ remoterepository = RemoteExample
 
 # autorefresh = 5
 
+# You can tell offlineimap to do a number of quicker synchronizations
+# between full updates.  A quick synchronization only synchronizes
+# if a Maildir folder has changed, or if an IMAP folder has received
+# new messages or had messages deleted.  It does not update if the
+# only changes were to IMAP flags.  Specify 0 to never do quick updates,
+# -1 to always do quick updates, or a positive integer to do that many
+# quick updates between each full synchronization (requires autorefresh).
+
+# quick = 10
+
 [Repository LocalExample]
 
 # This is one of the two repositories that you'll work with given the
@@ -188,12 +192,29 @@ localfolders = ~/Test
 
 sep = .
 
+# Some users on *nix platforms may not want the atime (last access
+# time) to be modified by OfflineIMAP.  In these cases, they would
+# want to set restoreatime to yes.  OfflineIMAP will make an effort
+# to not touch the atime if you do that.
+#
+# In most cases, the default of no should be sufficient.
+
+restoreatime = no
+
 [Repository RemoteExample]
 
 # And this is the remote repository.  For now, we only support IMAP here.
 
 type = IMAP
 
+# The following can fetch the account credentials via a python expression that
+# is parsed from the pythonfile parameter. For example, a function called
+# "getcredentials" that parses a file "filename" and returns the account
+# details for "hostname".
+# remotehosteval = getcredentials("filename", "hostname", "hostname")
+# remoteusereval = getcredentials("filename", "hostname", "user")
+# remotepasseval = getcredentials("filename", "hostname", "passwd")
+
 # Specify the remote hostname.
 remotehost = examplehost