NAME
getlive - fetch mail from your Hotmail Live account
SYNOPSIS
getlive [--config-file FILE] [--verbosity 0..100]
DESCRIPTION
getlive is a utility that fetches mail from your Hotmail/Windows Live
account. The mail is then presented to any filter (typically procmail)
for further processing or dropping in a local mailbox.
OPTIONS
--config-file
Default is ${HOME}/.getliverc. The format for this file is
listed below.
--verbosity
Higher number corresponds to greater output as command runs.
CONFIGURATION FILE
The configuration file takes arguments of the form option = value.
Empty lines or lines commented with # are allowed.
UserName
Your Hotmail username, excluding the at-sign and domain.
Domain The domain for your account, defaults to hotmail.com.
Mode Compatibility mode: 201002 (default), 200809, 200810, 200902, or
200909. 200810, 200902, and 200909, 201002 need to be used for
changes that are being rolled out in the hotmail service as of
October 2008.
Password
Your account password, you should restrict access to your
configuration file to avoid this information being read by other
users.
Proxy Hostname of proxy, if applicable.
ProxyAuth
Password for proxy, if applicable.
Downloaded
File that keeps track of IDs of messages that were fetched
already. Default is ${HOME}/.getlive.log.
FetchOnlyUnread
If Yes only messages that are marked unread are fetched. If set
to Yes, Downloaded is ignored. Defaults to No.
RetryLimit
Number of times to retry fetching a web page via curl. Defaults
to 2.
CurlBin
Command for curl. Default is "curl -k".
Processor
Any command taking the message in mbox format on its stdin and
doing something with it. Default is /usr/bin/procmail.
· "/bin/cat - >> FetchedMail" might be used to drop directly in
a mbox file.
· The distribution contains also
/usr/share/doc/getlive/examples/SmtpForward.pl and
/usr/share/doc/getlive/examples/SmtpAuthForward.pl These can
be used to forward the messages to an SMTP server.
Folder Folder that needs to be fetched. This option must be repeated
for each folder you want to fetch. If this option is not present
then all folders will be fetched.
MarkRead
Whether the message will be marked read after being downloaded.
Note that a message never gets marked in any way if it’s not
downloaded due to it being already in the Downloaded file.
Defaults to No.
Delete Whether the message will be deleted after being downloaded.
Note that a message never gets deleted if it’s not downloaded
due to it being already in the Downloaded file. Defaults to No.
MoveToFolder
Folder to which the message must be moved after being
downloaded. If this argument takes the form @FileName then the
folder name is taken from the contents of the file.
This can be used, for example, to enable a spam filter to decide
to what folder the message must be moved. That spamfilter would
be invoked by the Processor option and then write a folder name
(for instance Junk if considered junk) to the file FileName.
Note that a message is not moved if it’s not downloaded due to
it being already in the Downloaded file.
SkipTrash
Whether the Trash folder handling will be skipped or not.
Defaults to No.
BreakOnAlreadyDownloaded
Number of consecutive already downloaded messages after which
the search will stop. Useful to avoid slowness on extremely
large Downloaded files.
AUTHOR
getlive was written by Jos De Laender <jos.de_laender@pandora.be>.
This manual page was adapted by Tyler Trafford <ttrafford@gmail.com>
and Martin Ferrari <tincho@debian.org> from the included Manual, for
the Debian project (but may be used by others).
October 28, 2007